Content
85%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-orchestrated, instruction-style skill body: lean prose, concrete inputs and outputs, a clearly sequenced five-phase workflow with resumable checkpoints and an explicit identity-validation gate, and exemplary progressive disclosure into per-phase reference files. The only minor tightening opportunities are the duplicated resumption instructions and the delegation of execution detail to references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence — no priming on what clinical trials or epidemiology are; the Framing section adds only non-obvious guidance with concrete examples. Score 4 rather than 5 because resumption guidance is stated twice ("If the workdir already has waypoints, read them, summarize what's done, and ask which phase to resume from" in Output layout, then again nearly verbatim in "## Resuming"), which could be merged. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: defined inputs with defaults ("Defaults to ./do_not_commit/indication-dossier-<slug>/"), a tools table with fallback behavior, an output file tree, and per-phase instructions naming what to establish, which tools to use, and which waypoint file to write. Score 4 rather than 5 because the body delegates the actual step-by-step execution detail to the reference files, so a reader of the body alone has minor gaps. | 4 / 5 |
Workflow Clarity | Five phases are clearly sequenced, each with a resumable waypoint checkpoint and a required ≤200-word summary; Phase 1 has an explicit validation gate (ask_user with Proceed / Revise identity / Stop) with a graceful fallback ("proceeding on this interpretation; interrupt now to correct it"), and resumption rules include a never-overwrite-without-confirmation safeguard. This matches anchor 5's explicit validation steps and error-recovery feedback loop. | 5 / 5 |
Progressive Disclosure | The body is a concise overview with well-signaled, one-level-deep references (references/00 through 06 plus waypoint-schemas.md), all of which exist in the bundle and contain substantive per-phase detail; each is loaded exactly when its phase runs. Cross-references between reference files stay within one level, matching anchor 5's clear overview with easy navigation. | 5 / 5 |
Total | 18 / 20 Passed |