Agent Development

Create a markdown file in the plugin's agents directory with YAML frontmatter containing name, description, model, and color fields, followed by a system prompt body. The description must include triggering conditions and example blocks showing when the agent activates.

Four fields are required: name (lowercase with hyphens, 3-50 characters), description (triggering conditions with examples), model (inherit, sonnet, opus, or haiku), and color (blue, cyan, green, yellow, magenta, or red). The tools field is optional for restricting access.

Use example blocks containing Context, a user message, an assistant response, and commentary explaining why the agent triggers. Include 2-4 examples covering explicit requests, proactive triggering, and varied phrasings of the same intent.

Triggering fails when description examples lack relevant keywords, contexts do not match real usage, or commentary omits the triggering logic. Add more examples with different phrasings and ensure each shows the assistant invoking the agent.

System prompts should be between 20 and 10,000 characters, with 500-3,000 characters being typical. Write in second person, include core responsibilities, a step-by-step process, quality standards, output format, and edge case handling.