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.
A well-structured, highly actionable workflow skill: concrete CLI commands with expected JSON fields, explicit status-driven branching, and useful guardrails. Its only weaknesses are minor repetition between the steps and Guardrails sections and a weak error-recovery path for the 'all blocked' state.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and command-first with no explanations of concepts Claude already knows, but a few points are repeated — 'context and rules are constraints, do NOT copy them into the file' appears in step 3 and again in Guardrails, and 'create ONE artifact per invocation' is stated at both line 72 and line 110. Minor trimming would reach anchor 5. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready commands with exact flags ('openspec list --json', 'openspec status --change "<name>" --json', 'openspec instructions <artifact-id> --change "<name>" --json'), precise JSON fields to parse, a concrete AskUserQuestion presentation spec, and clear output-path guidance. Specific examples cover the common cases (all complete / ready / blocked). | 5 / 5 |
Workflow Clarity | A clear numbered sequence with three explicit status branches, a STOP rule after one artifact, and a verify guardrail ('Verify the artifact file exists after writing before marking progress'). However, the 'all blocked' branch offers only 'suggest checking for issues' with no real feedback loop, leaving a minor validation gap versus anchor 5. | 4 / 5 |
Progressive Disclosure | The single self-contained file is well organized (Input, Steps, Output, Artifact Creation Guidelines, Guardrails) with no nested references and nothing requiring external files. At ~107 lines it exceeds the simple-skill note, and the spec-driven artifact patterns section could arguably move to a reference file, so it fits anchor 4's 'good structure; minor organization gaps' rather than a clean 5. | 4 / 5 |
Total | 17 / 20 Passed |