Creates a new agent definition file with role description, capabilities, trigger keywords, file-type routing, escalation paths, and integration points. Validates against the existing agent roster to avoid duplicates. Registers the agent in the routing table.
SkillScore96Maintained
Automatic
◆AI Engineer pack
Last verified 8/27/2026
What it changes
Passed 21 of 22 test cases with the skill, and 6 of 22 without it.
Without skill26%
With skill96%
Checks it passed that the model alone missed
Assigns haiku as the tier
Assigns sonnet as the tier
Assigns opus as the model tier
and 23 more in the full report
16 fixed6 passed either way1 still failing0 broke
Pass-rate lift
+70 pp
Tokens
-16%
Agent turns
0%
Response time
-41%
Model gemini-3.6-flashMeasured 8/27/2026v122 of 23 cases passed with skill · 22 comparable
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 15 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 15
Prompt
Provide the exact slash command invocation to create an agent called 'doc-writer' responsible for generating technical documentation with tier set to haiku.
What was checked, without and with the skill
Checked
Without skill
With skill
Includes the --role flag in the command
Missed
Passed
Includes --tier haiku in the command flags
Passed
Passed
case-15 · gemini-3.6-flash · 8/27/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md36 linessingle file
/create-agent
Define a new specialist agent with role, capabilities, triggers, and routing rules.
Creates a new agent definition file with role description, capabilities, trigger keywords, file-type routing, escalation paths, and integration points. Validates against the existing agent roster to avoid duplicates. Registers the agent in the routing table.
Implementation
Check roster -- verify no existing agent covers this role.
Define agent -- create agent definition with:
Name and role description
Tier assignment (opus for elite, sonnet for specialist, haiku for utility)
Trigger keywords for automatic routing
File-type associations
Capabilities and limitations
Escalation paths (when to hand off)
Write definition -- create agents/<name>.md following agent template.
Register -- add to routing table in CLAUDE.md.
Validate -- confirm no routing conflicts with existing agents.
Examples
# Create a new specialist agent
/create-agent "data-engineer" --role "ETL pipelines and data modeling" --tier sonnet
# Create with specific triggers
/create-agent "mobile-dev" --role "React Native development" --tier sonnet --triggers "mobile, iOS, Android, React Native"
# Create a utility agent
/create-agent "formatter" --role "Code formatting and style enforcement" --tier haiku