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.
An instruction-only workflow skill with excellent actionability and workflow clarity — executable CLI commands, explicit validation loops, and precise stop conditions throughout. Its only weaknesses are minor repetition of the planning-boundary and store-flag rules, and monolithic inline storage of edge-case details that could live in a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient, procedural, and assumes Claude's competence (no explanations of basic concepts, exact JSON fields to parse, exact commands). Minor redundancy could be trimmed — the planning-boundary rule is restated nearly verbatim in "Planning boundary" and "Guardrails", and the store-flag instruction appears in both the "Store selection" preamble and Steps 2–3. | 4 / 5 |
Actionability | Commands are copy-paste ready with placeholders ("openspec new change \"<name>\"", "openspec instructions <artifact-id> --change \"<name>\" --json") and the skill specifies exactly which JSON fields to read (applyRequires, requires edges, resolvedOutputPath). This fully matches the anchor for executable guidance covering the common cases. | 5 / 5 |
Workflow Clarity | The six steps are clearly sequenced with explicit feedback loops (re-run `openspec status --change` after each artifact), explicit stop conditions ("Stop when every artifact in the required set is done, skipped, or was deliberately skipped"), and per-artifact verification ("Verify each artifact file exists after writing before proceeding to next"). This matches the anchor with validation steps and error-recovery checkpoints for a batch operation. | 5 / 5 |
Progressive Disclosure | The body is well organized with headers, steps, and guidelines, and there are no nested or dead references. However, at ~137 lines with no bundle files, detailed edge-case material (store-selection mechanics, required-set closure rules, schema-resolution branches) is inlined in the main file rather than split into a one-level-deep reference, leaving minor organization gaps relative to the score-5 anchor. | 4 / 5 |
Total | 18 / 20 Passed |