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 tight, highly actionable orchestrator body: executable commands, exit-code-driven routing, and a well-sequenced workflow with explicit gates and recovery loops. The main defect is navigation — three cited reference documents are missing from the bundle, and the ../../references/ paths resolve to nothing relative to SKILL.md.
Suggestions
Ship cma-primitives.md and loops-and-workflows.md inside the skill's own references/ directory and link them relative to SKILL.md; the current ../../references/ paths escape the skill directory and resolve to no file in the bundle.
Give interview-to-config.md (cited in the forcing-question library) a resolvable path, or inline the six intake slots it is cited for.
Trim the opening paragraph, which previews the routing/compiling/forked-intake details that the Routing, Compile the loop, and Hand-off contract sections restate.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean — no basic-concept explanations, dense tables, and tight gate/question lists — but the opening paragraph previews routing, compiling, and forked intake that later sections restate (e.g., 'Heavy intake stays in the forked context; the parent gets a digest' duplicates the Hand-off digest rule). Anchor 4 fits: efficient with minor trimming possible; not anchor 5 because of this duplication. | 4 / 5 |
Actionability | Both core commands are copy-paste executable with full flags ('python3 scripts/goal_router.py --out-dir ./my-agent'; the loop_compiler.py invocation with --max-iterations/--cron/--timezone/--nest-outcome), exit-code semantics (0/3/4) are documented, goal_state.py init is shown with a real example, and the hand-off contract names the exact fields to pass. Guidance is fully executable. | 5 / 5 |
Workflow Clarity | Clear sequence (run router → act on exit code → compile loop → fork to sub-skill → goal_state.py advance → digest) with explicit validation checkpoints and feedback loops: exit 3 ASK and exit 4 REFUSE each define an ask-then-re-route recovery loop, and the four pre-flight gates ('No goal set', 'Goal too vague', 'Never make API calls', 'Never print the key') act as a hard-refusal checklist. | 5 / 5 |
Progressive Disclosure | References are clearly signaled as markdown links and the body is well-sectioned, but the actual bundle (SKILL.md + scripts/ with goal_router.py, goal_state.py, loop_compiler.py) contains none of the cited documents: ../../references/cma-primitives.md and ../../references/loops-and-workflows.md escape the skill directory two levels up and do not exist, and interview-to-config.md is cited with no resolvable path. Clearly signaled but broken against the real bundle structure — better than anchor 2's buried/inlined-content problems, short of anchor 4's 'minor organization gaps'. | 3 / 5 |
Total | 17 / 20 Passed |