enhance-agent-prompts

# enhance-agent-prompts Analyze agent prompt files for prompt engineering best practices. ## Parse Arguments ```javascript const args = '$ARGUMENTS'.split(' ').filter(Boolean); const targetPath = args.find(a => !a.startsWith('--')) || '.'; const fix = args.includes('--fix'); const verbose = args.includes('--verbose'); ``` ## Agent File Locations | Platform | Global | Project | |----------|--------|---------| | Claude Code | `~/.claude/agents/*.md` | `.claude/agents/*.md` | | OpenCode | `~/.config/opencode/agents/*.md` | `.opencode/agents/*.md` | | Codex | `~/.codex/skills/` | `AGENTS.md` | ## Workflow 1. **Discover** - Find agent .md files 2. **Parse** - Extract frontmatter, analyze content 3. **Check** - Run 30 pattern checks 4. **Report** - Generate markdown output 5. **Fix** - Apply auto-fixes if --fix flag ## Detection Patterns ### 1. Frontmatter (HIGH) ```yaml --- name: agent-name # Required: kebab-case description: "What and when" # Required: WHEN to use (see "Intern Test") tools: Read, Glob, Grep # Required: restricted list model: sonnet # Optional: opus | sonnet | haiku --- ``` **Model Selection:** - **opus**: Complex reasoning, errors compound - **sonnet**: Most agents, validation - **haiku**: Mechanical execution, no judgment **Tool Syntax:** `Read`, `Read(src/**)`, `Bash(git:*)`, `Bash(npm:*)` **The "Intern Test"** - Can someone invoke this agent given only its description? ```yaml # Bad description: Reviews code # ...