Content
92%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.
An exceptionally lean, high-signal skill body: a clearly sequenced seven-step retro process with genuine validation gates (freshness check, evidence thresholds, falsification-before-proposal), concrete commands, and a clean overview-plus-references structure where every referenced bundle file exists and carries the promised executable detail. The only weakness is minor: a few collection steps (guardrail check command, freshness SQL) are named in the body but only fully specified in the reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is pure imperative guidance with zero padding — no concept explanations (no 'what a retro is', no library primers), and dense rules like "Cluster only on >=3 evidences. One anecdote is not a finding." and "Dead hypotheses die here, silently." assume Claude's competence throughout. Re-checking anchor 4 ('minor instances of over-explanation that could be trimmed'): nothing in the body is over-explained, so the 5 anchor ('every token earns its place') is the best fit. | 5 / 5 |
Actionability | Concrete commands are given directly — `ywai eval run --days <n> --worktree <w> --json`, `GET /api/evals/runs`, `git log --since=<n>.days`, `mem_save` — and the full command list (verified copy-paste-ready curl/SQL in references/queries.md) is one link away. It is not a 5 because a few items in the body are named but not executable on their own ("repo check command + hooks + CI workflow" never specifies the command, and the freshness SQL is only described as "raw SQL, read-only" in the body). | 4 / 5 |
Workflow Clarity | Seven named, sequenced steps (Scope → Collect → Validate → Cluster → Interrogate → Propose → Report+save) with explicit validation gates: freshness check before analysis ("A blind tracker is finding #1, not a footnote"), thresholds applied at step 3 ("thin window → widen AND retitle"), evidence minimum (">=3 evidences"), and a falsification loop at step 5 ("write the disproof before the proposal... Run it"). Recovery paths are stated ("One failed source never stops the run") and the workflow is read-only with output confined to the OS temp dir, so no destructive-operation cap applies. This matches the 5 anchor (explicit validation steps + feedback loops + checklist-style Rules section); anchor 4's 'minor validation gaps' does not describe this body. | 5 / 5 |
Progressive Disclosure | The body is a lean overview with clearly signaled, purpose-labeled, one-level-deep references — "Full command list in [references/queries.md]", "Apply [references/thresholds.md]", "Method in [references/analysis.md]", "Report as HTML (see [references/report.md])", plus `assets/report-template.html` — and every referenced path was verified to exist as a substantive file (queries.md 65 lines of ready commands, thresholds.md decision table, analysis.md 50 lines, template 203 lines). References do not nest further (report.md points only to the sibling template asset), matching the 5 anchor for well-signaled one-level-deep splitting. | 5 / 5 |
Total | 19 / 20 Passed |