Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-organized, concise router skill with clear sequencing, verification checkpoints, and properly structured one-level-deep references. Its only weakness is actionability: the SKILL.md itself contains no executable commands, deferring all concrete commands to the bundle files.
Suggestions
Include one or two inline quick-start chunk-cli commands (e.g., `chunk init`, `chunk validate`) in the body so Claude can handle simple requests without always loading a reference file.
Strengthen the 'Close with verification' step by naming a concrete verification command or UI check (e.g., `chunk validate --list` or confirming the 'Allow Chunk tasks' toggle) rather than only describing the report to produce.
Add an explicit error-recovery feedback loop (e.g., 'If a command fails, re-run a read-first command like `status`/`list` before retrying') to turn the verification checkpoint into a true validate-and-retry loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | A lean ~44-line overview that assumes Claude's competence, explains no background concepts, and has every section (Overview, Workflow, Guardrails, Reference Map, Output Contract) earning its place with no padding. | 3 / 3 |
Actionability | The body provides concrete routing guidance (which path for which task, which reference to load, exact output contract) but contains no executable commands itself — all actual chunk-cli commands are deferred to the bundle files, so it is not copy-paste ready at the SKILL.md level. | 2 / 3 |
Workflow Clarity | A clear four-step sequence (classify -> gather context -> execute -> close with verification) with an explicit verification checkpoint and prerequisite-validation guardrails ('verify those first', 'confirm local OS compatibility and required tokens/auth'), matching the clear-sequence-with-validation anchor. | 3 / 3 |
Progressive Disclosure | A clear overview with a dedicated Reference Map signaling two one-level-deep, real bundle files (chunk-ui.md, chunk-cli.md, both present), with content appropriately split between routing overview and detailed references. | 3 / 3 |
Total | 11 / 12 Passed |