Content
76%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 an exemplarily lean overview that delegates detail correctly to one-level-deep references. Its weaknesses are a never-defined evidence gate and orphaned bundle files (two scripts and two reference docs) that the overview never surfaces.
Suggestions
Define or link the evidence gate (e.g. point to references/CLAIM-EXTRACTION.md's promotion rule) and add an explicit validate-before-writing step for the batch note-generation flow.
Reference the bundled scripts (scripts/build_literature_canvas.py, build_literature_graph.py) and the unreferenced references/CANVAS-WORKFLOW.md and GRAPH-WORKFLOW.md from the body or Read-next so they are discoverable.
Add one-line labels to each Read-next entry (e.g. 'Paper notes: references/PAPER-NOTE-SCHEMA.md') so navigation is self-describing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 47-line body is lean and efficient with zero padding: a one-line flow, a default-outputs list, terse rules, and a Read-next pointer list. No concept Claude already knows is explained, and every token earns its place — a clean match for anchor 5. | 5 / 5 |
Actionability | Concrete, executable guidance is present: exact output paths ('Sources/Papers/{paper-slug}.md', 'Knowledge/Claim Map.md'), and a specific promotion contract ('Evidence Record ID, source type, claim strength, allowed wording, and forbidden stronger wording'). It falls short of anchor 5 because the bundled scripts (build_literature_canvas.py, build_literature_graph.py) are never invoked or linked, and no worked example appears inline — minor gaps rather than missing key details. | 4 / 5 |
Workflow Clarity | The sequence exists ('Sources/Papers/ -> Knowledge/ -> Writing/ -> Maps/literature.canvas') and a checkpoint is referenced ('only after promoted claims pass the evidence gate'), but the gate itself is never defined or linked in the body, and there is no explicit validate-then-proceed step for a workflow that batch-generates notes. This matches anchor 3 — sequence present but checkpoints implicit. | 3 / 5 |
Progressive Disclosure | The body is a genuine overview with one-level-deep references: all six Read-next files exist and (verified in CLAIM-EXTRACTION.md and others) point no deeper. It is not anchor 5 because the Read-next list is unlabeled, and several bundle files — both scripts, CANVAS-WORKFLOW.md, and GRAPH-WORKFLOW.md — are orphaned, never referenced from SKILL.md, which hurts navigation and discovery. | 4 / 5 |
Total | 16 / 20 Passed |