Content
75%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-constructed instruction-only skill body: lean, concrete, and sequenced, with real error-recovery guidance and a fully specified output artifact. The residual gaps are minor — implicit validation checkpoints, an unspecified CLI write command, and three stub sections that exist only to satisfy a conformance test.
Suggestions
Replace "put_page via the standard CLI flow" with the actual command(s) so Phase 5 is fully executable without consulting other skills.
Fold the three conformance-test stub sections (Contract, Output Format, Anti-Patterns) into a single brief note or the body sections they point to, removing the duplicated pointer text.
Add one explicit mid-process checkpoint, e.g. "Before Phase 3, confirm the strategic problem is specific enough to triage against; if vague, ask the user" — to make validation as explicit as the failure handling.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and purposeful — a concrete output template, a five-phase process tree, and a quality bar with a worked example — with only minor trimmable material, matching the 4 anchor ("efficient; minor instances of over-explanation"): the three stub sections ("Contract", "Output Format", "Anti-Patterns") that exist only "for the conformance test" and rhetorical flourishes ("devastatingly relevant", "reading with a mission") add tokens without adding guidance. | 4 / 5 |
Actionability | Concrete, executable guidance dominates: "pdftotext -layout", "Read first 2000 chars of each chapter", HIGH/MEDIUM/LOW triage rules, explicit output paths ("projects/<slug>/playbook.md"), and a full markdown template for the artifact; it falls short of the 5 anchor only on minor gaps such as "put_page via the standard CLI flow" (no actual command given) and EPUB extraction being delegated to another skill's SKILL.md. | 4 / 5 |
Workflow Clarity | The five phases are clearly sequenced with concrete parameters per phase, and the "When it fails" section provides genuine feedback loops ("revision_conflict or write_pending (exit 10): re-read and merge, or poll gbrain write-request <request_id>"); a point below the 5 anchor because mid-process checkpoints (e.g., confirming the strategic problem is well-defined before deep reading, or verifying the written page) are implicit rather than explicit validation steps. | 4 / 5 |
Progressive Disclosure | The body is well-organized with clear section headers and clearly signaled one-level-deep cross-references ([conventions/quality.md], [_brain-filing-rules.md], book-mirror and perplexity-research SKILL.mds); no bundle files exist in this skill (references/, scripts/, assets/ are absent), and the inline brain-page template is core content that belongs in SKILL.md, so this matches the 4 anchor — the conformance-test stub sections at the end are minor organizational clutter that keeps it from a 5. | 4 / 5 |
Total | 16 / 20 Passed |