Content
75%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 lean, well-sequenced, largely copy-paste-ready instruction set: exact commands per platform and numbering mode, an explicit prerequisite check with graceful degradation, and concrete short-name guidance. The only real gaps are the absence of error-handling guidance after script invocation and slight redundancy between the prerequisites and degradation sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section carries instructions Claude would not already know, e.g. "Verify Git is available by running `git rev-parse --is-inside-work-tree 2>/dev/null`" and "Do NOT pass `--number`"; the only trimmable parts are the overlap between "Prerequisites" and "Graceful Degradation" and some script-behavior detail under "Environment Variable Override" — anchor 4 (efficient, minor over-explanation). Not 5 because of those small redundancies; not 3 because nothing pads or explains known concepts. | 4 / 5 |
Actionability | Gives full executable commands for both platforms and both modes (".specify/extensions/git/scripts/bash/create-new-feature.sh --json --short-name \"<short-name>\" \"<feature description>\"") plus concrete short-name examples ("add-user-auth", "fix-payment-bug") and explicit config-check order — anchor 4 (concrete commands with minor gaps). Not 5 because it stops short of how to parse the JSON output or what to do if the script errors; not 3 because nothing is pseudocode or vague. | 4 / 5 |
Workflow Clarity | The sequence (input → env override → git prerequisite check → numbering-mode selection → execution → degradation → output) is clear, with an explicit validation checkpoint ("If Git is not available, warn the user and skip branch creation") and a defined fallback with an exact warning string — anchor 4 (clear sequence, most checkpoints present). Not 5 because there is no feedback loop for script failure or unexpected JSON output; not 3 because checkpoints are explicit and the operation is neither destructive nor batch. | 4 / 5 |
Progressive Disclosure | No bundle files exist, and the ~62-line body is fully self-contained under clean section headers, with nothing that clearly belongs in a separate file — anchor 4 (good structure, content appropriately placed). Not 5 because the under-50-line simple-skill exception does not strictly apply at this length and the detailed env-override behavior list could arguably live in a reference; not 3 because structure is clean with no buried or nested references. | 4 / 5 |
Total | 16 / 20 Passed |