enhance-agent-prompts
Use when improving agent prompts, frontmatter, and tool restrictions.
Profile →npx skills add agent-sh/agentsys --skill enhance-agent-prompts --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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, va
- Parse Arguments
- Agent File Locations
- Workflow
- Detection Patterns
- 1. Frontmatter (HIGH)
- 2. Structure (HIGH)
- 3. Instruction Effectiveness (HIGH)
- 4. Tool Configuration (HIGH)
- 5. Subagent Config (MEDIUM)
- 6. XML Structure (MEDIUM)
- 7. Chain-of-Thought (MEDIUM)
- 8. Examples (MEDIUM)
- 9. Loop Termination (MEDIUM)
- 10. Error Handling (MEDIUM)
What does the enhance-agent-prompts skill do?
Use when improving agent prompts, frontmatter, and tool restrictions.
How do I install it?
Run `npx skills add agent-sh/agentsys --skill enhance-agent-prompts --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From agent-sh/agentsys, a repository with 923 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.