This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
SkillScore100Maintained
Automatic
◆AI Engineer pack
Last verified 8/19/2026
What it changes
Passed 22 of 22 test cases with the skill, and 9 of 22 without it.
Without skill41%
With skill100%
Checks it passed that the model alone missed
The response specifies inherit as the recommended model attribute value.
The response specifies scripts/validate-agent.sh as the validation tool.
The response states the description length must be between 10 and 5000 characters.
and 13 more in the full report
13 fixed9 passed either way0 still failing0 broke
Pass-rate lift
+59 pp
Tokens
+89%
Agent turns
0%
Response time
-55%
Model gemini-3.6-flashMeasured 8/19/2026v122 of 22 cases passed with skill
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 13 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 13
Prompt
Which utility script from the repository is used to validate an agent markdown file's structural correctness?
What was checked, without and with the skill
Checked
Without skill
With skill
The response specifies scripts/validate-agent.sh as the validation tool.
Missed
Passed
case-17 · 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.md430 linessingle file
Developing Agents for Claude Code Plugins
Overview
Agents are autonomous subprocesses that handle complex, multi-step tasks independently. Understanding agent structure, triggering conditions, and system prompt design enables creating powerful autonomous capabilities.
Key concepts:
Agents are FOR autonomous work, commands are FOR user-initiated actions
Markdown file format with YAML frontmatter
Triggering via description field with examples
System prompt defines agent behavior
Model and color customization
Agent File Structure
Complete Format
---
name: agent-identifier
description: Use this agent when [triggering conditions]. Examples:
<example>
Context: [Situation description]
user: "[User request]"
assistant: "[How assistant should respond and use this agent]"
<commentary>
[Why this agent should be triggered]
</commentary>
</example>
<example>
[Additional example...]
</example>
model: inherit
color: blue
tools: ["Read", "Write", "Grep"]
skills: ["skill-name"]
---
This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
Provide help with the Dialogue Framework. Triggers on "how does dialogue work", "what commands", "explain phases", "framework help", "what can you do".