Content
67%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 densely operational, highly actionable workflow document: every phase has concrete gates, branch logic, and fallbacks, and the two reference files are real and well-signaled. Its weaknesses are redundancy (protocol distinctions restated verbatim across sections and rules repeating phase text) and the inlined 13-protocol catalog that inflates the body at the cost of navigability.
Suggestions
Deduplicate the /inquire-vs-/apportion (and other distractor-pair) distinctions — they are spelled out at length in the Data Sources rows, the Phase 5 feedback example, and the Quiz Design section; state each once and reference it.
Move the 13-protocol Data Sources catalog to a reference file (e.g., references/protocols.md) and keep a compact name + one-line trigger table in SKILL.md, tightening the 100+ word rows.
Trim Rules 2, 9, and 10, which restate mechanics already specified in Phase 2a, Phase 1, and the fallback tiers, and resolve the Phase 2a/2b/2 numbering collision (e.g., rename to Phase 2 Pick/Evidence and Phase 3 Map with downstream phases renumbered or lettered).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence (e.g., "Resolve it ONCE per invocation with Bash `printf '%s\n' "${CLAUDE_CONFIG_DIR-$HOME/.claude}"`" and the byte-bounded "read only the first 256 KB of each record") with no known-concept padding, but the /inquire-vs-/apportion distinction is written out at full length three times (Data Sources rows, the Phase 5 feedback example, and Quiz Design), and Rules 2/9/10 restate phase text. Anchor 3 ("mostly efficient … could be tightened"), not 2, since most tokens carry unique operational instruction rather than explanation. | 3 / 5 |
Actionability | Guidance is concrete and executable for an instruction-only skill: exact gate option text, explicit branch handling ("If no signals detected … recommend `/elicit`"), pool-exhaustion transitions, and precise record-selection rules ("Glob `{config_dir}/projects/*/*.jsonl` … Exclude partitions whose name contains `-worktrees-`"). Anchor 4 rather than 5 because sample renderings — e.g., what an evidence card or a one-sentence recommendation actually looks like — are described by rules but never shown. | 4 / 5 |
Workflow Clarity | Phases 0–6 are clearly sequenced with per-path preconditions ("Quick path only", "Targeted path only"), an explicit skip rule ("targeted + standard → skip Phases 1-2, jump to Phase 3"), named state variables, a gate-call budget table, and fallbacks at every failure point (no records, unparseable lines, pool exhaustion). Anchor 4 rather than 5 because the section numbering collides — "Phase 2a: Pick", "Phase 2b: Evidence", and "Phase 2: Map" are three separate headers sharing the number 2 — which mildly obscures navigation. | 4 / 5 |
Progressive Disclosure | Both referenced bundle files (`references/scenarios.md`, `references/advanced-usage.md`) exist and are cited at their point of use, one level deep and clearly signaled ("Use the **Trial prompt** field from `references/scenarios.md`"). Anchor 4 rather than 5 because the 13-protocol Data Sources catalog — including single table rows exceeding 100 words (e.g., the Merismos `/apportion` row) — is inlined in SKILL.md where it is natural reference material that belongs in a separate file. | 4 / 5 |
Total | 15 / 20 Passed |