Content
56%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 action-rich with concrete commands and real validation checkpoints, but it is over-long, repeats caveats across milestone sections, and inlines reference-grade material (schemas, category lists) that should live in separate files given nothing is bundled.
Suggestions
Extract the proposal payload schema, CSA forced-gate categories, and reflect.sh mechanics into reference files under ./references/ and link to them one level deep, reducing the inline SKILL.md to an overview.
Deduplicate the companion-offset / ephemeral-live-clusters.json caveat — state it once in the drain section and reference it, rather than repeating it in session-drain, PROPOSE, and verification.
Trim milestone history and SPEC-citation prose (dates, 'stalled for 3 weeks', 'died with its owning session') to the minimum needed to justify a design choice; move time-sensitive version/date detail to a deprecated/old-patterns section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | At ~383 lines the body is noticeably verbose: it restates the ephemeral-live-file / companion-offset caveat 3+ times, narrates milestone history ('died with its owning session (2026-08-04)', 'stalled for 3 weeks'), and carries many date-stamps and SPEC citations that pad without aiding action. | 2 / 5 |
Actionability | Provides concrete executable invocations and flags — 'drain.sh --inbox <path> --state-dir <dir>', 'session_drain.sh', 'reflect.sh --memory-dir <m> [--threshold 150]' — plus runnable jq verification snippets; minor gaps (placeholder <drain-start-timestamp>, scripts described rather than bundled). | 4 / 5 |
Workflow Clarity | The drain is a numbered 7-step pipeline followed by an explicit 'Verification' section with a pass/fail jq predicate ('must print: true') and a mutant-probe feedback loop, and REFLECTION has a no-op gate; the multi-stage M1–M4 layout scatters rather than consolidates the sequence, keeping it just below 5. | 4 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ absent), so all content — proposal payload schema tables, CSA forced-gate category lists, reflect.sh mechanics — is inlined; section headers give structure but material that belongs in separate reference files is not split out. | 3 / 5 |
Total | 13 / 20 Passed |