Content
77%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is highly actionable and exceptionally well-sequenced with strong validation feedback loops, but it is verbose with notable repetition and keeps most procedural detail inline rather than splitting it into bundled reference files.
Suggestions
Consolidate the repeated 'external-openspec-skill-override' and OpenSpec compatibility precheck rules into a single stated-once section to reduce token redundancy across steps 1, 1a, and 2.
Move the detailed JSON-schema compatibility predicates and the idempotent recovery algorithm into a bundled reference file (e.g. comet/reference/openspec-contract.md) and link to it from SKILL.md so the overview stays lean.
Actually ship the referenced comet/reference/*.md files in the skill's references/ bundle so the one-level-deep navigation is real rather than pointing at external paths.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is operational and avoids explaining concepts Claude already knows, but ~265 lines with the compatibility precheck, changeRoot/applyRequires rules, and the external-skill-override block repeated three times pad the token budget and could be tightened. | 2 / 3 |
Actionability | Provides copy-paste-ready commands (`comet classic openspec -- status ...`, `comet state init/select/check`, `comet guard ... --apply`) and exact JSON-field predicates and artifact trees, leaving no ambiguity about what to run. | 3 / 3 |
Workflow Clarity | A clearly numbered sequence (0 through 5) with explicit validation checkpoints, blocked→missingDeps→fix→re-run feedback loops, an idempotent recovery algorithm, and mandatory hard checks before phase transition. | 3 / 3 |
Progressive Disclosure | References to comet/reference/*.md and the openspec-* skills are clearly signaled and one level deep, but the body is a large monolithic wall of inline procedural detail and the referenced comet/reference/* files are not present in this skill's bundle (references/scripts/assets are empty). | 2 / 3 |
Total | 10 / 12 Passed |