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 a strong, actionable procedure: executable commands for both shells, an explicit naming contract, and a concrete validation regex with abort-on-failure. Its main weaknesses are mild duplication and a stale Output section that contradicts the mandated branch-naming scheme.
Suggestions
Replace the Output section's legacy examples (`003-user-auth`, `20260319-143022-user-auth`) with examples matching the mandated scheme (e.g. `v1/feat/STAFF-0003-create-employee-cqrs-commands`), or remove the section since the naming contract is already stated.
Merge "Graceful Degradation" into "Prerequisites" — both cover the git-unavailable case — and keep one warning message.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes Claude's competence — it never explains git or branching basics — but "Prerequisites" and "Graceful Degradation" overlap, and the "Output" section repeats stale information. These are minor instances of over-explanation that could be trimmed, matching anchor 4 rather than the fully lean anchor 5. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready guidance: the exact availability check (`git rev-parse --is-inside-work-tree`), concrete Bash and PowerShell invocations with a worked example value, an explicit `GIT_BRANCH_NAME` contract, and an exact validation regex. Specific examples cover the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | Clear sequence (verify git → resolve inputs → compose name → execute → validate) with an explicit post-creation validation regex and abort-on-mismatch. Not 5 because recovery stops at 'abort and report' with no fix-and-retry guidance, and the final Output section's examples (`003-user-auth`, `20260319-143022-user-auth`) contradict the mandated naming scheme, creating sequence ambiguity. | 4 / 5 |
Progressive Disclosure | Well-organized single-file structure with clear section headers and no nested or buried references; no bundle files exist and none are needed for this single-task skill. Not 5 because at ~105 lines it exceeds the under-50-line simple-skill zone and the contradictory trailing Output section is a minor organization gap, matching anchor 4. | 4 / 5 |
Total | 17 / 20 Passed |