| name | agent-add |
| description | Create a new Claude Code agent file (review or team type) following the official sub-agent schema and token-efficiency budgets. Use when the user wants to add a new review agent, detect a new category of code issue, create a team agent persona, or says things like "add an agent for X", "create a reviewer for Y", "new team agent for Z". Also use when given a URL to a coding standard that should become a review agent. |
| argument-hint | <description-or-url> [--plugin <dir>] [--name <name>] [--type review|team] [--effort low|medium|high] [--context diff-only|full-file|project-structure] [--lang <exts>] [--dry] |
| user-invocable | true |
| allowed-tools | Read, Write, Edit, Grep, Glob, WebFetch, Skill(plugin-audit *) |
Agent Add
Role: implementation.
Implementation constraints
- Follow the official sub-agent schema and token budgets.
- Delegate the build to the agent-create skill; do not improvise structure.
- Be concise. Report the created agent file, no narration.
Steps
1. Parse arguments
Capture the agent name/spec or URL from $ARGUMENTS.
2. Delegate
Invoke the agent-create skill with the arguments.
3. Report
Output the created file path.
Apply the guidelines defined in skills/agent-create/SKILL.md to the current
task. Read the skill file and follow its steps exactly.
If $ARGUMENTS starts with http:// or https://, fetch the URL with
WebFetch first and extract the relevant guidance, then use that content as
the agent description.
Pass these flags through to the skill as context:
--plugin <dir> → target plugin directory (resolved by agent-create Step 0)--name <name> → set agent name (skips name prompt)--type review|team → set agent type (skips type prompt)--effort low|medium|high → sets the agent's effort band (invalid values rejected; legacy tokens mapped, e.g. frontier → high)--context diff-only|full-file|project-structure → sets Context needs: field--lang <exts> → adds language scope declaration to the body--dry → show generated content without writing to disk or updating registry
Apply this skill to: $ARGUMENTS
