Content
78%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 content is a tight, actionable validation procedure with exact patterns, commands, and outputs — exactly the kind of non-derivable detail a skill should carry. Its main weaknesses are the mildly duplicated Git-unavailable handling across two sections and the absence of a concrete command for the spec-directory lookup.
Suggestions
Consolidate the Git-unavailable case into one place: either Prerequisites points to the SPECIFY_FEATURE fallback in Graceful Degradation, or merge the two sections so the skip-vs-fallback behavior is unambiguous.
Provide an executable form of the spec-directory check, e.g. 'ls -d specs/<prefix>-*' or a glob example like 'specs/STAFF-0003-*', so the lookup is copy-paste ready like the other commands.
Clarify which pattern takes precedence when a branch matches multiple conventions (e.g. a sequential branch that also carries a ticket segment).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: exact regex patterns, concrete commands, and prescribed output strings with no filler or explanations of known concepts. It falls short of 5 due to mild duplication between 'Prerequisites' (skip validation when Git is unavailable) and 'Graceful Degradation' (fallback to SPECIFY_FEATURE), which could be merged into one section. | 4 / 5 |
Actionability | Concrete, copy-paste-ready commands ('git rev-parse --abbrev-ref HEAD'), exact regexes, and example branch names make the guidance mostly executable. It is not 5 because the spec-directory check ('look for specs/<prefix>-*') is described rather than given as an executable command or glob example. | 4 / 5 |
Workflow Clarity | The sequence (check Git -> get branch name -> match patterns -> verify spec directory -> report) is clearly ordered with explicit pass/fail outputs for each branch of the workflow. A minor gap: the Prerequisites section says to skip validation when Git is unavailable, while Graceful Degradation says to fall back to SPECIFY_FEATURE, leaving the exact behavior slightly ambiguous. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines, single-purpose, and needs no external references; the well-organized sections (Prerequisites, Validation Rules, Execution, Graceful Degradation) satisfy the simple-skill exception for a top score. All content is appropriately inlined with nothing that belongs in a separate file. | 5 / 5 |
Total | 17 / 20 Passed |