skill-portfolio-review
Installation
SKILL.md
Skill Portfolio Review
Portfolio-level audit of all skills as a collection. While /skill-quality-gate audits one skill's internal quality, this skill audits the fleet: are skills in the right surface, are any redundant, is context budget spent wisely?
Gotchas
| Gotcha | What happens | Do instead |
|---|---|---|
| Recommending DELETE without checking dependencies | Hooks, cross-references, or CLAUDE.md triggers break silently | Always run dependency check (Step 3) before any DELETE recommendation |
| Counting imperative keywords in examples as railroading | A gotchas table containing "NEVER do X" inflates the imperative counter | Discount imperatives inside tables, examples, and quoted blocks |
| Classifying meta-skills as "doesn't fit taxonomy" without nuance | Some meta-skills (/operate) provide genuine value despite not fitting the 9 categories | Classify as "meta — justify keeping" rather than auto-DELETE |
| Merging skills that happen to overlap in description but differ in execution | save-session and introspect both mention "session" but do fundamentally different things | Read both SKILL.md files fully before recommending MERGE |