agent-createlisted

## What this skill does Guides creation of a new agent markdown file. Provides the complete template structure, frontmatter schema, system prompt rules, and validation checklist to ensure the agent is codebase-specific, focused, and follows plugin-architect standards. ## How to execute this skill This skill is fully self-contained and works standalone on any tool. 1. Extract agent `name` from `output_path` (e.g. `/agents/git-detector.md` → `git-detector`) 2. Provide the frontmatter schema and body structure (see sections below) 3. Apply `focus_prompt` to ensure codebase-specificity and single responsibility 4. Generate the validation checklist 5. Return the template and checklist You can run this skill entirely on your own — no agent orchestration is required. ## Agent file structure Agent markdown files follow this structure: ```markdown --- name: <agent-name> description: <one inline string — when to invoke and what it owns> model: sonnet tools: <comma-separated list or omit if not needed> --- <system prompt — codebase-specific, focused on exactly one role> ``` ## Frontmatter schema (required) **Universal fields:** - `name` — lowercase letters and hyphens only; must match filename without `.md` - `description` — single inline string (no block scalars); explain when to invoke and what it exclusively owns - `model` — use `sonnet` unless blueprint specifies otherwise **Optional fields:** - `tools` — comma-separated list of tools this agent needs (minimal, only wh