Content
86%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-crafted, self-contained instruction skill: concrete executable commands for every step, a clearly sequenced workflow with explicit stopping points and useful guardrails, and no padding. The only refinements would be trimming minor redundancy and adding light handling for command failures.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient: concrete commands, no explanations of concepts Claude already knows, and tight sections. A few tokens could be trimmed — the '**IMPORTANT**: Do NOT proceed without understanding' note restates step 1, and the '--schema' guardrail repeats steps 2-3 — so it falls just short of the lean anchor 5 while being well above anchor 3. | 4 / 5 |
Actionability | Fully executable copy-paste commands are given for every step ('openspec new change "<name>"', 'openspec status --change "<name>"', 'openspec instructions <first-artifact-id> --change "<name>"', 'openspec schemas --json'), along with a concrete name-derivation example ('add user authentication' → 'add-user-auth') and a verbatim question for the AskUserQuestion tool. This matches the anchor for copy-paste-ready commands covering the common cases. | 5 / 5 |
Workflow Clarity | A clear numbered 1-6 sequence with an explicit STOP step and guardrail feedback loops for error recovery (invalid kebab-case name → ask for a valid one; existing change → suggest continuing). It falls short of anchor 5 because there is no validation of command output or handling of command failure (e.g., what to do if 'openspec new change' errors), though the operation is non-destructive so the cap-at-3 rule does not apply. | 4 / 5 |
Progressive Disclosure | This is a simple, self-contained skill (~45 content lines) with no need for external reference files, and none are bundled. Content is well organized into Input, Steps, Output, and Guardrails sections with nothing that belongs in a separate file, which per the rubric's simple-skill provision merits a 5. | 5 / 5 |
Total | 18 / 20 Passed |