Reviewing Skills

Review skills for predictable agent behavior, not just readability.

Workflow

1. Identify the target skill directory and read SKILL.md completely.

2. Read references/best-practices.md before producing findings.

3. Check frontmatter name and description for trigger precision and exclusions.

4. Check the body for clear steps, completion criteria, progressive disclosure, duplication, no-ops, sediment, and sprawl.

5. Inspect bundled references, scripts, assets, and evals when present.

6. Return prioritized findings before optional rewrites.

Report Shape