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 tightly written, fully executable workflow: concrete CLI commands, parsed JSON contracts, explicit validation checkpoints (status re-checks, file-existence verification), and user-input feedback loops. The only issues are mild redundancy across the Guidelines/Guardrails sections and a body slightly long for a single-file skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and command-driven with no concept explanations, but there is repetition that could be trimmed: 'read dependency artifacts before creating a new one' appears in Steps, Artifact Creation Guidelines, and Guardrails, and 'IMPORTANT' is used twice for near-identical context/rules warnings. These minor redundancies keep it below the every-token-earns-its-place anchor of 5. | 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`) plus explicit JSON fields to parse (applyRequires, template, outputPath, dependencies) and exact output phrasing. The only unspecified content — the artifact file itself — is correctly delegated to the CLI-provided template rather than duplicated. | 5 / 5 |
Workflow Clarity | The five-step sequence is explicit with a dependency-ordered loop, a re-check after each artifact (re-run `openspec status` and stop when all applyRequires artifacts are 'done'), a file-existence verification guardrail, and feedback loops (ask via AskUserQuestion when context is unclear; suggest continuing an existing change). This matches the anchor for clear sequencing with explicit validation and error-recovery loops. | 5 / 5 |
Progressive Disclosure | With no bundle files, the ~90-line body is appropriately self-contained and well-sectioned (Input, Steps, Output, Artifact Creation Guidelines, Guardrails) — nothing here belongs in a separate reference since the CLI supplies templates at runtime. It sits just past the under-50-line threshold and lacks an explicit overview section header, so 'good structure with minor organization gaps' (4) fits better than 5. | 4 / 5 |
Total | 18 / 20 Passed |