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 second-person system prompt. The description must include triggering conditions and 2-4 example blocks showing when the agent activates.

Four fields are required: name (lowercase with hyphens, 3-50 characters), description (triggering conditions with example blocks), model (inherit, sonnet, opus, or haiku), and color (blue, cyan, green, yellow, magenta, or red). The tools field is optional and restricts tool 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, implicit needs, and proactive triggering after relevant work.

Agents fail to trigger when description examples lack relevant keywords, contexts do not match actual usage, or commentary does not explain the triggering logic. Add more examples with varied user phrasings and verify the assistant invokes the agent in each example.

System prompts should be between 20 and 10000 characters, with 500-3000 characters being typical. Include clear responsibilities, step-by-step process, quality standards, output format, and edge-case handling written in second person.