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. You can generate it with AI assistance using the provided creation prompt or write it manually following the templates.

Agents require name (lowercase with hyphens, 3-50 characters), description (trigger conditions starting with "Use this agent when"), model (inherit, sonnet, opus, or haiku), and color (blue, cyan, green, yellow, magenta, or red). The tools field is optional for restricting access.

Write the description field as flat prose naming 2-4 trigger scenarios, and add a "When to invoke" body section with detailed prose bullets covering both explicit user requests and proactive triggering after relevant work. Avoid quoted user utterances; describe situations instead.

Run the bundled validate-agent.sh script with the agent file path. It checks frontmatter structure, required fields, name format and length, model and color values, and system prompt length, reporting errors and warnings.

System prompts should stay between 20 and 10,000 characters, with 500-3,000 characters recommended. Prompts must be written in second person, define clear responsibilities, process steps, and output format, and should not exceed five trigger scenarios.