Content
78%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 pack overview: pack-specific, competent-assuming, and correctly split between a lean SKILL.md and one authoritative reference. The main improvement room is trimming the source-reference-convention detail duplicated from the reference, and briefly surfacing the refresh/validation failure-handling instead of leaving it entirely in the referenced file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with pack-specific detail and assumes Claude's competence (no explanations of what a wiki, mermaid, or git HEAD is); every section carries rules Claude could not infer. Not a 5 because the source-reference convention section repeats implementation detail (brokenLinks `no-such-file`/`unresolvable` behavior, `../` hop counting) that the body itself says fully "lives in references/generate-and-refresh.md", so a few sentences could be trimmed without loss. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: the exact `wiki/` directory shape, mode-detection rule ("a stubbed `OVERVIEW.md` (empty `source_commit`) → generate... a stamped `source_commit` → refresh"), toolset routing rules, a copy-paste log-entry markdown template, template names with the exact call `write({ document: { path, template: "<name>" } })`, and knob value enumerations. Not a 5 because the full operational procedure is deliberately delegated to the reference, so some specifics (OK verb syntax, phase steps) are absent from the body itself. | 4 / 5 |
Workflow Clarity | The generate sequence is summarized inline ("survey → overview → architecture → modules → flows → concepts → link-graph audit") with refresh as a diff-driven counterpart, STOP-gating and the link-graph audit are named, and two MUST-discipline sections (always re-stamp `source_commit`, one log entry per run) act as explicit checkpoints for this batch-write workflow. Not a 5 because the explicit validation steps and error-recovery loops (e.g. brokenLinks handling on failure, what to do when the Hocuspocus server is down) live in the reference rather than being surfaced even briefly in the body. | 4 / 5 |
Progressive Disclosure | Textbook structure: SKILL.md is a lean overview (folder shape, knobs, conventions, MUST disciplines) with the full procedure split into a single one-level-deep reference, `references/generate-and-refresh.md` (verified present), clearly and repeatedly signaled via markdown links at each relevant section. Templates are described without inlining their content, and the body explicitly avoids repeating full details it delegates. | 5 / 5 |
Total | 17 / 20 Passed |