Content
71%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 a lean, well-structured operational document with strong actionability — exact flags, output schemas, formats, and gate checkpoints — and only minor redundancy between the execution rules and gates. Its main weakness is progressive disclosure: it repeatedly defers to stage-specific files (map.md and unspecified 'stage-specific files') that are absent from the bundle, and the Study mode from the Modes table is missing from the Stages table.
Suggestions
Either include the stage-specific files (map.md, etc.) in the bundle or replace the dangling references with self-contained instructions; if the files exist at runtime, reference them as resolvable paths/links rather than bare names.
Add the Study and Teach rows (or note why they are absent) to the Stages table so the mode → gate → output mapping is complete and consistent with the Modes table.
Remove the duplicate framing — the intro paragraph repeats the description verbatim and several execution rules restate GATEs (rule 2/GATE-U5, rule 4/GATE-U4) — and clarify what 'output_dir: resolved by raptor-run-lifecycle' concretely means for the operator.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — tables for modes and stages, no tutorials on concepts Claude already knows — but the opening paragraph repeats the frontmatter description almost verbatim, the execution rules and GATEs partially restate each other (e.g. rule 4 vs GATE-U4, rule 2 vs GATE-U5), and the runtime-probe section is wordier than needed. Not 5 due to this duplicated material; not 3 because the padding is minor, not whole unnecessary sections. | 4 / 5 |
Actionability | Concrete, executable guidance throughout: exact command flags (--map, --trace <entry>), exact file-reference and flow formats, named JSON outputs (context-map.json, flow-trace-<id>.json, variants.json), and a precise checklist-item schema table. As an instruction-only skill the absence of code is not penalized. Not 5 because some operational details are unresolved in-body ('output_dir: resolved by raptor-run-lifecycle' defers a value without a pointer, and how/where the modes are invoked is never shown); not 3 because the guidance goes well beyond high-level hints. | 4 / 5 |
Workflow Clarity | The Stages table cleanly sequences mode → gates → output, the execution rules are numbered, and the gates act as explicit checkpoints (READ-FIRST, EVIDENCE-ONLY confidence matching is effectively a validation gate). Not 5 because there is no explicit feedback/error-recovery loop and the Stage table omits Study (which appears in the Modes table), leaving a minor gap; not 3 because checkpoints are explicit and the sequence is coherent. | 4 / 5 |
Progressive Disclosure | The body is well-sectioned and explicitly defers detail ('See stage-specific files for detailed instructions', 'MAP-7 in map.md'), but the bundle contains no stage-specific files — no references/, scripts/, or assets/ exist, and map.md is referenced by name without a path or link, so the signaled references dangle. Per the guideline to score against the actual bundle structure, the clearly-signaled one-level references point at files that are not present, leaving navigation broken despite good in-file organization. Not 2 because the SKILL.md itself is appropriately split and the references are clearly signaled, not buried; not 4 because referenced files cannot actually be reached. | 3 / 5 |
Total | 15 / 20 Passed |