Content
81%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.
This is a strong operational skill body: it gives exact, executable commands for every branch of a complex stateful workflow, with real validation checkpoints and error-recovery paths. Its main weakness is repetition of the same do-not-stop-early warning, which inflates length without adding information.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Nearly all content is skill-specific operational knowledge Claude cannot know (CLI commands, resume semantics, working-file layout), but the core warning 'do not stop after plan new' is repeated three times — the STOP blockquote, the 'This is a loop' section, and the 'Concretely' paragraph — and the version-check preamble is similarly heavy. This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than 4, where over-explanation would be only minor. | 3 / 5 |
Actionability | Every instruction is copy-paste executable: exact commands with full JSON payloads ('spektacular plan new --data '{"name": "<spec_name>"}''', 'spektacular design ref list --data ...'), exact file paths (.spektacular/work/<plan_name>/<section>.md, .spektacular/tmp/), and precise placeholder conventions. This fully matches anchor 5 (fully executable, copy-paste ready commands covering the common cases). | 5 / 5 |
Workflow Clarity | The workflow is explicitly sequenced (version check → spec selection → plan new → instruction/goto loop → walkthrough → finished) with genuine validation gates and feedback loops: the mandatory version check before anything else, the uncommitted-changes and auto_commit_failed question/error handling, the verification step over staged documents, broken design references that stop and report rather than plan around the gap, and the mandatory user sign-off before 'finished'. This matches anchor 5 (clear sequence with explicit validation steps and feedback loops for error recovery). | 5 / 5 |
Progressive Disclosure | The body is well-structured with clear top-level sections (version check, tracing, what the skill does, file I/O, design refs, decisions, working files, how to start, orchestrator mode) and no nested or buried references — appropriate for a standalone skill with no bundle files. It does not reach anchor 5 because sections like the orchestrator-mode rules and the detailed resume procedure are inline content that could arguably live in a separate reference file, leaving minor organization gaps per anchor 4. | 4 / 5 |
Total | 17 / 20 Passed |