agent-create

Agent Create

Automates production of Claude Code sub-agent files that pass schema validation and stay within token-efficiency budgets. For conventions, anti-patterns, and registration checklists, see skills/agent-skill-authoring/SKILL.md.

Constraints

• Do not write any file until validation passes and the user confirms the draft
• Name validation is a hard gate — exit immediately if the name is invalid
• Never include hooks, mcpServers, or permissionMode without explicit user confirmation after the plugin warning
• Body line budgets are hard limits enforced at generation time; trim content is shown to the user before any file is written
• Registry and CLAUDE.md updates are append-only; never edit existing rows

---

Step 0 — Resolve Target Plugin

Determine $PLUGIN (the target plugin directory) and $NAME (the plugin's name field from .claude-plugin/plugin.json):

1. If --plugin <dir> was passed, use that directory as $PLUGIN.
2. Else if exactly one plugins/*/ directory exists in the repo root, use it.
3. Else if the current working directory is inside a directory containing .claude-plugin/plugin.json, use that directory.
4. Else ask: Which plugin directory should the agent be added to?

Read $PLUGIN/.claude-plugin/plugin.json and extract the name field as $NAME. All subsequent path references use $PLUGIN/ and $NAME.

---

Step 1 — Parse Arguments

Accept these inputs (from arguments or interactive prompts):

Input	Required	Notes
name	yes	file stem of the new agent
type	yes	review or team
description	yes	one-line summary for frontmatter
tools	no	comma-separated tool list
--plugin <dir>	no	target plugin directory (resolved in Step 0)
--model sonnet|opus|haiku|fable|inherit|<full model ID>	no	model the agent runs on; a value is suggested and confirmed in Step 5 if omitted
--effort low|medium|high|xhigh|max	no	reasoning effort for this agent; a value is suggested and confirmed in Step 5 if omitted
--memory user|project|local	no	persistent memory scope; omitted unless specified
--isolation worktree	no	run in an isolated git worktree; omitted unless specified
--color red|blue|green|yellow|purple|orange|pink|cyan	no	display color in the task list/transcript; omitted unless specified
--max-turns <int>	no	cap on agentic turns before the subagent stops; omitted unless specified
--background true|false	no	always run as a background task; omitted unless specified
--skills <name1,name2,...>	no	skill names to preload into context at startup; omitted unless specified
--context diff-only|full-file|project-structure	no	sets Context needs: field in review body
--lang <exts>	no	adds language scope line to review body (e.g. Scope: .ts, .tsx files only)
--dry	no	display generated content without writing file or updating registry