Content
100%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 model command-dispatch skill: every command has a copy-paste-ready invocation, exact JSON schemas for the two LLM-analysis steps, explicit user-confirmation gates on all save/delete operations, dry-run and backup safety on migration, and error-handling rules — all delivered with no padding. One caveat outside the body's text: the referenced scripts (commands/*.mjs, hooks/session-start.mjs) were not present in the reviewed bundle, though this appears to be an artifact of what was provided for review rather than the body's structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and operational: exact bash invocations (e.g., 'node "$HOME/.claude/skills/ck/commands/init.mjs"'), a compact data-layout tree, exact JSON schemas, and one-line rules. It explains nothing Claude already knows and every token is instructional, matching anchor 5 ('Lean and efficient; assumes Claude's competence'). Not anchor 4 — there is no over-explanation left to trim; the repeated 'Display output verbatim' lines are necessary per-command instructions. | 5 / 5 |
Actionability | Guidance is fully executable and copy-paste ready: concrete node commands for all seven commands, piping patterns ('echo '<json>' | node ".../save.mjs"'), an exact JSON schema ('{"summary":"...","leftOff":"...","nextSteps":["..."],...}'), a confirmation-draft template, and a complete settings.json hook registration block. Matches anchor 5 ('Fully executable; copy-paste ready... specific examples cover the common cases'); not anchor 4, since no common case is missing. | 5 / 5 |
Workflow Clarity | Multi-step flows are explicitly sequenced with validation checkpoints: init (run script → present confirmation draft → 'Wait for user approval' → pipe confirmed JSON), save (analyze → 'Wait for confirmation' → pipe), forget ('This will permanently delete context... Are you sure? (yes/no)' before the destructive delete), and migrate ('--dry-run' first; 'Originals are backed up... nothing is deleted'). Feedback loops are present ('If a script exits with code 1, display its stdout as an error message'; malformed projects.json → 'offer to reset it to {}'), so the destructive/batch cap-at-3 rule does not apply. Matches anchor 5 with explicit validation and error-recovery handling. | 5 / 5 |
Progressive Disclosure | The body is a well-sectioned overview (Data Layout, per-command sections, SessionStart Hook, Rules) with trivial header-based navigation; no bundle files exist, and no material that belongs in a separate file is inlined — the JSON schemas and hook snippet are each only a few lines placed at point of use, while the bulk detail correctly lives outside SKILL.md as executable scripts. Matches anchor 5's 'easy navigation' and appropriate placement; not anchor 4, as there are no organization gaps or misplacements. | 5 / 5 |
Total | 20 / 20 Passed |