Content
88%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 dense, highly operational skill body: every step is executable with exact commands, validation gates, and failure fallbacks, and detail is properly deferred to a real reference file. Its only shortcomings are minor — a few prose sections that could be trimmed and a signal table whose content overlaps the bundled reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — it explains only repo-specific failure modes ("a `git add` of the whole of it sweeps in anything a concurrent session left there") and never concepts Claude already knows — but a few sections could be tightened, e.g. the "Where this sits" prose and the twice-visited transcripts-absent rationale, leaving minor over-explanation rather than the leanest possible form. | 4 / 5 |
Actionability | Fully executable throughout: copy-paste bash for every step (`bun run --cwd tools/pr-metrics card -- --resolve-issue`, the branch-slug `tr -c 'a-zA-Z0-9._-' '-'` transform, the `grep -c '^<details><summary>Session metrics'` duplicate check), exact flag semantics, and a complete `RETRO.md` template covering the common cases. | 5 / 5 |
Workflow Clarity | A clearly sequenced Steps 1–7 workflow with explicit validation and recovery: environment probes before Step 1, the duplicate-block check before appending to the PR body ("read the body out and append to it — never compose a new one"), and per-failure fallbacks ("No `gh`: write the card with whatever identity you know and leave the block in a file"). | 5 / 5 |
Progressive Disclosure | Good structure with a single, verified, one-level reference (`references/card-signals.md`) clearly signaled ("Read it before Step 3") and external detail correctly deferred to `wiki/conventions/session-metrics.md` and `tools/pr-metrics/README.md`; however, the 330-line body's Step 4 signal table overlaps the reference file's role and some of it could be split out, leaving minor organization gaps. | 4 / 5 |
Total | 18 / 20 Passed |