Content
85%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, highly executable validation procedure with exact commands, regexes, and output strings, and a clear decision tree with graceful degradation. Its only real flaws are a duplicated git-unavailable case across two sections and one described-but-not-commanded lookup step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with zero concept-explanation padding, but the git-unavailable case is stated twice — in Prerequisites ('If Git is not available, output a warning and skip validation') and again in Graceful Degradation ('If Git is not installed or the directory is not a Git repository') — a minor duplication that could be trimmed. This places it between anchor 4 (minor over-explanation) and anchor 5 (every token earns its place), closer to 4. | 4 / 5 |
Actionability | Mostly copy-paste ready: 'git rev-parse --is-inside-work-tree 2>/dev/null', 'git rev-parse --abbrev-ref HEAD', exact regexes with examples, and exact output strings. It falls short of 5 because the spec-directory lookup ('look for specs/<prefix>-*') is described rather than given as an executable command (e.g., an ls/glob invocation). | 4 / 5 |
Workflow Clarity | A simple, single-task validation skill (~54 lines) with an unambiguous decision tree: check git availability, get the branch name, match against the two patterns, emit the exact per-case output, check the spec directory, and fall back to SPECIFY_FEATURE. Every branch of the flow has an explicit outcome, and the operation is read-only so no destructive-operation validation cap applies. | 5 / 5 |
Progressive Disclosure | The skill is short with no external references needed; content is appropriately self-contained and organized into well-signaled sections (Prerequisites, Validation Rules, Execution, Graceful Degradation) with no buried or nested references. Per the rubric's simple-skill guidance, well-organized sections alone merit the top score here. | 5 / 5 |
Total | 18 / 20 Passed |