Content
92%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-engineered, CLI-driven workflow skill: fully executable commands, explicit JSON parsing guidance, validation checkpoints, and a status-recheck loop that doubles as progressive disclosure by pulling artifact templates dynamically. The only real improvement is consolidating the thrice-repeated context/rules warning to trim a few tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient overall — literal commands, structured steps, and no explanations of concepts Claude already knows. The one recurring flaw is that the "context and rules are constraints for YOU, do NOT copy them into the file" instruction is repeated three times (in step 4a, in the Artifact Creation Guidelines, and in the Guardrails), which could be consolidated; this is minor over-emphasis rather than the padded sections of anchor 3. | 4 / 5 |
Actionability | Every step gives copy-paste-ready commands (`openspec new change "<name>"`, `openspec status --change "<name>" --json`, `openspec instructions <artifact-id> --change "<name>" --json`) with the JSON fields to parse (`applyRequires`, `artifacts`, `template`, `outputPath`) fully specified. Pulling detailed templates from the CLI at runtime is a complete, executable design that covers the common cases; it is not anchor 4 because there are no real gaps in what to execute. | 5 / 5 |
Workflow Clarity | The 5-step sequence is explicit with a dependency-ordered artifact loop, validation checkpoints ("Verify each artifact file exists after writing before proceeding to next"), and a genuine feedback loop ("After creating each artifact, re-run openspec status --change ... Stop when all applyRequires artifacts are done") plus a recovery path ("If an artifact requires user input ... Use AskUserQuestion tool"). Validation is present, so the batch-operation cap does not apply, and the Guardrails section serves as the checklist anchor 5 asks for. | 5 / 5 |
Progressive Disclosure | There are no bundle files, and none are needed: the skill is a single coherent workflow whose per-artifact detail is deliberately fetched at runtime via `openspec instructions`, which is progressive disclosure done right. The body is cleanly sectioned (Input, Steps, Output, Artifact Creation Guidelines, Guardrails) with no content that belongs in a separate file, so nothing is inlined that should be split out. | 5 / 5 |
Total | 19 / 20 Passed |