Content
78%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.
A well-structured, instruction-style body: concrete commands, a clear sequence with an explicit stop point, and a useful guardrails section. The only real weaknesses are a thrice-repeated --schema instruction and the absence of a verify-succeeded feedback loop after the scaffold command.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative with no concept explanations Claude would already know; commands are given without padding. It is not a 5 because the --schema guidance is repeated three times (step 2, step 3, and the guardrails' 'Pass --schema if using a non-default workflow'), which could be trimmed to one statement. | 4 / 5 |
Actionability | Concrete, copy-paste-ready CLI commands are given for each phase ('openspec new change "<name>"', 'openspec status --change "<name>"', 'openspec instructions <first-artifact-id> --change "<name>"'), plus the exact open-ended question text to ask. It is not a 5 because minor gaps remain: no example with a concrete change name, and no guidance for handling CLI failures (e.g., invalid name errors beyond the guardrail note). | 4 / 5 |
Workflow Clarity | A clear six-step sequence with an explicit STOP checkpoint (step 6), a status-verification step (step 4), and a guardrails checklist covering error recovery (invalid name → ask for a valid one; existing change → suggest continuing). It is not a 5 because there is no feedback loop after running 'openspec new change' — the skill does not say to verify the scaffold succeeded before proceeding to status. | 4 / 5 |
Progressive Disclosure | This is a small, self-contained, single-purpose skill with no external bundle files and no references in the body, so everything belongs inline; sections (Input, Steps, Output, Guardrails) are well-organized and easy to navigate. There are no nested or buried references to penalize, satisfying the simple-skill exception despite the body being marginally over 50 lines. | 5 / 5 |
Total | 17 / 20 Passed |