Content
70%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 strongly sequenced, guard-validated workflow with copy-paste CLI commands and explicit user-confirmation checkpoints — workflow clarity and actionability are high. Its weaknesses are redundant restatements of entry/recovery and compression rules, and inlining of handoff-format details that belong in a reference file.
Suggestions
State the entry-check/state-recovery and context-compression rules once and reference comet-classic/reference/context-recovery.md from each step, instead of repeating them in Step 0, Step 1e, Step 2, and the closing sections.
Move the handoff pack format details (design-context.json/md and beta spec-context structure, truncation markers, hash fields) into a reference file, keeping only the command and a one-line purpose inline in SKILL.md.
Include a short sample of the JSON output fields the workflow depends on (data.designReadiness, data.issues, agent.continuation) so validation and recovery steps can be executed without guesswork.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and procedural with no explanations of concepts Claude already knows, but the entry-check/state-recovery rules and context-compression rules are each restated three to four times across Step 0, Step 1e, Step 2, and the closing sections. This repetition is more than minor over-explanation, matching the 'mostly efficient but could be tightened' anchor rather than score 4's 'minor instances'. | 3 / 5 |
Actionability | Nearly every step is backed by exact, executable commands ('comet handoff <change-name> design --write', 'comet state complete-design <name> --design-doc "..." --json', 'comet guard <change-name> design --apply'), plus exact file paths, a frontmatter template, and a full brainstorm-summary.md template. It falls short of score 5 because the JSON result fields it relies on (data.designReadiness, data.issues, agent.continuation) are referenced without any sample output or field format. | 4 / 5 |
Workflow Clarity | Steps are clearly sequenced (0 entry check → 1a–1e design loop → 2 create Design Doc → 3 update state → 3a optional compression → exit conditions → auto-transition) with explicit validation checkpoints: the entry verification, the mandatory user confirmation gate in Step 1c, guard-enforced exit conditions, and a failure feedback loop ('失败时处理 data.issues,保留成果并重试同一 complete-design'). | 5 / 5 |
Progressive Disclosure | References to comet-classic/reference/*.md files are clearly named, but the skill's own bundle contains no reference files at all, and reference-grade detail — the default and beta handoff pack formats, truncation markers, hash fields, and compression-recovery rules — is inlined directly in SKILL.md. This matches the 'content that should be separate is inline' anchor rather than score 4's 'most content appropriately placed'. | 3 / 5 |
Total | 15 / 20 Passed |