Content
86%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 skill body that documents each bundled script with its flags, exit codes, and a validation-first entry point, while explaining only the non-obvious repo-specific constraints. Its main gaps are a templated rather than literal example invocation and an implicitly rather than explicitly stated collect-to-analyze sequence.
Suggestions
Add one fully literal end-to-end example (e.g., `pnpm exec tsx $H/analyze.ts --run <id> --focus src/foo.ts --regression-days 30`) so the templated invocation pattern becomes copy-paste ready.
Make the doctor -> collect -> analyze -> pr sequence explicit as a numbered workflow in the intro, rather than relying on the order of the Scripts list.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense with zero padding; the blobless-clone warning ("git show, git diff, git log -p ... fetch blobs one at a time and stall") is repo-specific, non-obvious, and load-bearing rather than background explanation. | 5 / 5 |
Actionability | Provides a concrete run command and per-script flags (--lookback-days, --focus, --regression-days, --pr N), but the entry command is a template ("tsx $H/<script>.ts --run <id> [...]") with no fully literal end-to-end example. | 4 / 5 |
Workflow Clarity | Sequence is present in listing order with a validation checkpoint (doctor.ts verifying base branch and gh auth), documented exit codes, and a re-run feedback loop ("re-run analyze.ts without collecting again"), but the collect-to-analyze ordering is implicit rather than explicit numbered steps; operations are read-only so the destructive/batch cap does not apply. | 4 / 5 |
Progressive Disclosure | Short, well-sectioned overview with the scripts living as real files in the bundle (scripts/doctor.ts, collect.ts, analyze.ts, pr.ts, lib.ts all exist) and external pointers (fragility-common, refactor-plan rubric) clearly signaled and one level deep. | 5 / 5 |
Total | 18 / 20 Passed |