Content
82%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-structured and highly actionable, with executable code, a clear classification table, sequenced workflows, and a concrete output template. Minor conciseness and organization refinements would bring it to the top level.
Suggestions
Remove the repeated 'Advisory only' reminders — state it once in Non-Goals and let the How It Works step 4 ('Advisory only: print the plan. Never run the matched commands.') carry it.
Consider hoisting the family-classification table into a references/ file (e.g. families.md) referenced one level deep, keeping SKILL.md as a lean overview with the classification-rule pointer.
Add a one-line verification checkpoint in match mode confirming the chosen family prefix actually appears in the live-read command list before emitting the run-order.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence, using a dense prefix-classification table rather than prose; minor redundancy ('Advisory only' appears in frontmatter, the How It Works block, and Non-Goals) could be trimmed. | 4 / 5 |
Actionability | Copy-paste-ready bash to live-read the commands directory, a concrete classification rule table, an exact output template, and worked match-mode examples with real command sequences fully cover the common cases. | 5 / 5 |
Workflow Clarity | Both 'How It Works' and 'Match mode' give clearly numbered, sequenced steps with an explicit stop-condition checkpoint; no validate-fix-retry loop is needed because the skill is advisory-only and never executes commands, so the destructive-cap does not apply. | 4 / 5 |
Progressive Disclosure | Single-file skill with no bundle files, organized into well-labeled sections (When to Activate, Core Principle, Family Classification, How It Works, Output Template, Examples, Non-Goals); the large family table is justified inline as the live classification rule, leaving only minor organization gaps. | 4 / 5 |
Total | 17 / 20 Passed |