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 content is a well-sequenced, highly actionable guided walkthrough with real commands, complete artifact templates, explicit pause checkpoints, and thorough fallback handling for exits and edge cases. Its main weaknesses are minor: a duplicated command reference table, no verification step after implementation, and slightly padded scripted narration in places.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient for a guided tutorial: nearly every block is a concrete template, scripted message, or command rather than explanation of concepts Claude already knows (e.g. it never explains what git or specs are; the WHEN/THEN note is one line and task-specific). Minor over-explanation exists in some scripted narration ('You can literally read them as test cases', the welcome block) that could be trimmed, keeping it just below the 'lean and efficient' level-5 anchor. | 4 / 5 |
Actionability | Guidance is fully executable: real CLI commands ('openspec status --json', 'openspec new change "<derived-name>"', 'openspec archive "<name>"'), exact file paths ('openspec/changes/<name>/proposal.md', 'specs/<capability>/spec.md'), and complete copy-paste-ready artifact templates for proposal, spec, design, and tasks covering the common cases. Placeholders like <name> are parameterization, not pseudocode, so it matches the top anchor rather than the level-4 anchor with 'minor gaps'. | 5 / 5 |
Workflow Clarity | An 11-phase sequence with a preflight initialization check, explicit PAUSE checkpoints, and fallback/error-recovery paths (not initialized, no tasks found, oversized scope, mid-way exit) — this goes beyond the level-3 anchor. It falls short of level 5 because there is no explicit verification step after implementation (the skill mentions '/opsx:verify' in the command table but never runs it during the cycle), a minor validation gap. | 4 / 5 |
Progressive Disclosure | No bundle files exist (no references/, scripts/, or assets/), and the skill is a single continuous guided flow where inlining is mostly appropriate; sections are clearly organized (Preflight, numbered phases, Graceful Exit Handling, Guardrails). Minor organization gaps — the command reference table appears twice (Phase 11 and the quick-reference exit path) and could be consolidated or split into a reference file — keep it at 'good structure; most content appropriately placed' rather than the level-5 ideal of well-signaled one-level-deep references. | 4 / 5 |
Total | 17 / 20 Passed |