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 2-4 example blocks showing when the agent activates.

Codex agents require name, description, model, and color fields, with tools as optional. The name must be 3-50 lowercase characters with hyphens, and the model field is typically set to inherit unless specific capabilities are needed.

Write triggering conditions starting with "Use this agent when" followed by 2-4 example blocks containing context, user request, assistant response, and commentary. Cover different phrasings of the same intent and explain why the agent triggers in each commentary.

Agent identifiers must be 3-50 characters using only lowercase letters, numbers, and hyphens, starting and ending with an alphanumeric character. Underscores, spaces, and leading or trailing hyphens are invalid.

Add a tools array to the frontmatter listing only the required tool names, such as ["Read", "Grep"] for read-only analysis. Omitting the field grants access to all tools, so apply least privilege by limiting tools to the minimum needed.