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.
The body is a tight, highly actionable workflow with concrete CLI commands, explicit guardrails, and a clear stopping point. Its only weaknesses are a thrice-repeated schema instruction and the absence of validation steps for command outcomes, which keep conciseness and workflow clarity just below top marks.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and free of concept explanations, but the schema rule is stated three times (step 2, step 3's "Add --schema <name> only if...", and the guardrail "Pass --schema if using a non-default workflow"). These repeated minor instances could be trimmed, matching the efficient-with-minor-overlap anchor of 4 rather than the every-token-earns-its-place 5. | 4 / 5 |
Actionability | The skill gives copy-paste-ready commands (`openspec new change "<name>"`, `openspec status --change "<name>"`, `openspec instructions <first-artifact-id> --change "<name>"`, `openspec schemas --json`) plus exact AskUserQuestion wording, and explains how to derive the one placeholder from status output. This is fully executable instruction-only guidance covering the common cases, matching the 5 anchor rather than the minor-gaps 4. | 5 / 5 |
Workflow Clarity | Steps 1-6 are clearly sequenced with a STOP checkpoint and guardrails for error conditions (invalid name, existing change), but there are no checks on command outcomes (e.g., what to do if `openspec new change` fails or status output is unexpected). This fits the clear-sequence-with-minor-validation-gaps anchor of 4; the 5 would require explicit validate-and-retry loops. | 4 / 5 |
Progressive Disclosure | The skill is a short, single-purpose workflow with no bundle files and no need for external references, yet is organized into clear Input, Steps, Output, and Guardrails sections. Under the simple-skill guideline this well-organized structure earns the top score. | 5 / 5 |
Total | 18 / 20 Passed |