Content
82%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-structured, highly actionable workflow skill: exact CLI commands, explicit JSON fields to parse, clear status-based branching, and a strict one-artifact-per-invocation guardrail. Its only weaknesses are mild redundancy in the constraint/guardrail guidance and the absence of error-recovery loops for failed commands.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient, assumes Claude's competence (no basic-concept explanations), and uses tight command blocks and bullets. Minor over-explanation could be trimmed: the rule that 'context' and 'rules' are constraints for the agent is stated in step 3 and then repeated as two bullets under Guardrails, and phrases like 'This shouldn't happen with a valid schema' and 'Congratulate the user' add little. This fits 'efficient; minor instances of over-explanation' (4) rather than the every-token-earns-its-place 5 anchor or the noticeably-verbose 3 anchor. | 4 / 5 |
Actionability | The guidance is fully executable: exact CLI commands ('openspec list --json', 'openspec status --change "<name>" --json', 'openspec instructions <artifact-id> --change "<name>" --json'), the specific JSON fields to parse (schemaName, artifacts, isComplete, template, outputPath, dependencies), concrete selection-criteria for the AskUserQuestion step, and per-artifact file patterns for the spec-driven schema. This matches the copy-paste-ready, common-cases-covered 5 anchor. | 5 / 5 |
Workflow Clarity | The sequence is clear and ordered (select change → check status → branch on isComplete/ready/blocked → create exactly one artifact → re-run status to show progress) with an explicit checkpoint ('Verify the artifact file exists after writing before marking progress'). It falls short of the 5 anchor because there are no error-recovery feedback loops for failed commands or invalid status output — but it is not a destructive or batch operation, and the sequence and checkpoints are otherwise solid, so the 4 anchor fits best. | 4 / 5 |
Progressive Disclosure | The skill has no bundle files (references/, scripts/, assets/ do not exist) and everything is inline. The body is well organized with clearly labeled sections (Input, Steps, Output, Artifact Creation Guidelines, Guardrails), and the ~105-line workflow is appropriately self-contained, though the schema-specific 'Common artifact patterns' detail could live in a reference file. This matches 'good structure; most content is appropriately placed; minor organization gaps' (4) rather than the 5 anchor, which the rubric reserves for shorter skills or those with well-signaled reference files. | 4 / 5 |
Total | 17 / 20 Passed |