Content
86%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 tight, executable, well-structured validation procedure that assumes Claude's intelligence and wastes no tokens; its only weakness is that the spec-directory lookup step is described narratively rather than as a runnable command.
Suggestions
Provide a concrete command or snippet for the spec-directory existence check (e.g. a `ls specs/ | grep` or `test -d` invocation per branch type) so the whole workflow is copy-paste ready.
Add an explicit recovery action when the spec directory is missing (e.g. 'warn and continue' vs. 'stop') to close the workflow-clarity gap toward a feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~46-line body is lean and efficient, with only concrete commands, complete regex patterns, and example branch names; it assumes Claude's competence and explains no background concepts, matching the score-5 anchor 'every token earns its place'. | 5 / 5 |
Actionability | Executable commands (`git rev-parse --is-inside-work-tree`, `git rev-parse --abbrev-ref HEAD`) and complete regex patterns with examples are provided, but the spec-directory existence check and ticket-segment extraction are described in prose rather than as a copy-paste runnable command, a minor gap that holds it below 5. | 4 / 5 |
Workflow Clarity | The Prerequisites → Validation Rules → Execution → Graceful Degradation sequence is clear with explicit checkpoints (git-availability gate, ✓/⚠/✗ output signals, spec-directory existence check), matching score 4; it stays below 5 because the spec-directory check is asserted without a concrete filesystem command and there is no explicit retry loop on a missing spec dir. | 4 / 5 |
Progressive Disclosure | This is a simple single-purpose skill under 50 lines with well-organized sections and no need for external references; no bundle files exist in references/scripts/assets to verify, so the simple-skill guideline allows a 5 for well-organized sections alone. | 5 / 5 |
Total | 18 / 20 Passed |