Content
88%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-built instruction-only skill: fully executable CLI commands, explicit dependency-ordered artifact loop with status re-checks and file-existence verification, and clear guardrails for ambiguity and name collisions. Remaining improvements are minor — deduplicating the repeated context/rules and re-read guidance, and moving the Store-selection boilerplate into a shared reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — numbered steps, copy-paste commands, and no explanation of concepts Claude already knows — matching the 'efficient; minor instances of over-explanation that could be trimmed' anchor. Not a 5 because the context/rules constraint ("do NOT copy <context>, <rules>...") is stated in full twice, and 'read dependency artifacts, re-read from disk' guidance is likewise repeated in both step 4 and the Guidelines section. | 4 / 5 |
Actionability | Commands are copy-paste ready (`openspec new change "<name>"`, `openspec status --change "<name>" --json`, `openspec instructions <artifact-id> --change "<name>" --json`) with the exact JSON fields to parse (`applyRequires`, `resolvedOutputPath`, etc.), matching the 'fully executable; copy-paste ready commands' anchor. The one abstract step (writing the artifact file) is legitimately driven by the CLI's runtime-provided template and resolved output path, which the skill handles explicitly. | 5 / 5 |
Workflow Clarity | The sequence is explicit with validation checkpoints: loop artifacts in dependency order, re-run `openspec status --json` after each creation, stop only when every `applyRequires` artifact reports `status: "done"`, and "Verify each artifact file exists after writing before proceeding". This batch file-generation workflow includes feedback loops and error/ambiguity handling (AskUserQuestion, existing-change collision), matching the top anchor and avoiding the batch-operation cap since validation is present. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent) and none are referenced, so there are no broken or nested-reference issues; the body is organized into clear sections (Store selection, Input, Steps, Output, Guidelines, Guardrails), matching 'good structure; minor organization gaps'. Not a 5 because at ~113 lines it exceeds the under-50-line simple-skill case, and the Store selection paragraph is boilerplate that likely recurs across sibling OpenSpec skills and belongs in a shared reference file. | 4 / 5 |
Total | 18 / 20 Passed |