Create and maintain Claude Code agents/subagents (.claude/agents/*.md) with YAML frontmatter (name/description/tools/model/permissionMode/skills/hooks), least-privilege tool selection, delegation patterns (Task), context budgeting, and safety best practices.
SkillScore95Maintained
Automatic
◆AI Engineer pack
Last verified 8/19/2026
What it changes
Passed 21 of 22 test cases with the skill, and 15 of 22 without it.
Without skill68%
With skill95%
Checks it passed that the model alone missed
The model property specifies opus
The file path specifies .claude/agents/secret-scanner.md
The tools field lists tool names in comma-separated or flat array format
and 7 more in the full report
7 fixed14 passed either way0 still failing1 broke
Pass-rate lift
+27 pp
Tokens
+10%
Agent turns
0%
Response time
-35%
Model gemini-3.6-flashMeasured 8/19/2026v121 of 22 cases passed with skill
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 7 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 7
Prompt
Provide the YAML frontmatter for an agent designed to optimize SQL queries and propose safe database indexes.
What was checked, without and with the skill
Checked
Without skill
With skill
The frontmatter description field details when to invoke the agent and what action it performs
Missed
Passed
case-05 · gemini-3.6-flash · 8/19/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md84 linessingle file
Claude Code Agents
Create and maintain Claude Code agents/subagents with predictable behavior, least-privilege tools, and explicit delegation contracts.
Quick Start
Create an agent file at .claude/agents/<agent-name>.md (kebab-case filename).