Save Session as Agent

.claude/agents/

Instructions

Step 1: Generate the agent file

1. User corrections are the most important signal. Every correction implies a rule the agent got wrong initially. Each correction MUST become an explicit rule.
2. Only capture what worked. If approach A failed and approach B worked — only document approach B.
3. Generalize — replace session-specific values (file names, URLs, credentials) with descriptive placeholders. The agent must work for similar tasks, not just this exact one.
4. Keep it concise — this is a system prompt for a subagent. Shorter is better.

---
name: "<kebab-case-name>"
description: "<one-liner, max 200 chars>"
tools: Read, Glob, Grep, Bash, Write, Edit
model: sonnet
---

You are an agent that <role description — what this agent does>.

## Behavior

1. <First step the agent should take>
2. <Next step>
3. <...>

## Rules

- <Rule derived from user correction or session learning>
- <Another rule>

## Output

<What the agent should produce — format, structure, location.>

Frontmatter Constraints

• name

  — required, kebab-case, max 100 characters

• description

  — required, max 200 characters

• tools

  — required, comma-separated list of tools the agent needs (choose from: Read, Glob, Grep, Bash, Write, Edit, WebFetch, WebSearch)

• model

  — required, use

  sonnet

  unless the task clearly needs stronger reasoning (then use

  opus

  )

Body Constraints

• Start with a one-sentence role description: "You are an agent that..."
• Behavior section: numbered steps describing what the agent does, in order
• Rules section: bullet list of constraints and guidelines — every user correction from the session MUST appear here
• Output section: what the agent produces and in what format
• All sections are required

Guidelines

• Write natural language instructions, not formal SHALL/MUST requirements
• Be specific — "Use openpyxl for Excel files" not "Use the right tool"
• Do NOT include session-specific details (specific file names, URLs, credentials, data values from this run)
• DO generalize patterns — replace specific values with descriptive placeholders like

  <input-file>

  ,

  <target-url>

• Only include steps that succeeded, not failed attempts
• The agent file MUST be self-contained — the subagent needs nothing beyond this prompt and its input

Step 2: Save the agent file

---

1. Extract the

   name

   from the YAML frontmatter. Use it as the slug directly (it's already kebab-case).
2. Create the

   .claude/agents/

   directory if it doesn't exist:
   bash

   mkdir -p .claude/agents

3. Write the agent file content to

   .claude/agents/{name}.md

   using the Write tool.

Step 3: Display the result

.claude/agents/{name}.md

@{name}