Content
96%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.
Excellent instructional content: maximally dense, concrete, and sequenced, with quantitative rules, named tools, explicit inconclusive criteria, and feedback loops throughout. The only gap is the three dangling playbook cross-references that assume external material the bundle does not ship.
Suggestions
Give the three playbook references a location (path or link) — e.g. 'per the **Opening a PR** playbook (playbooks/opening-a-pr.md)' — or inline the one rule being relied on so the skill stands alone.
The Hillclimb sentence ('The frozen harness then prints error and work counts...') only makes sense if the reader knows that playbook; add one clause stating the contract ('check the printed counts against questions 4 and 7') so it survives without the companion document.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and dense: every sentence instructs ("Profile in a run you do not report, because profilers and tracers slow the work down", "Run each side at least 5 times, alternating"). It names concrete tools inline (`top`, `pidstat`, `py-spy`, `perf`, `strace -c`, `uptime`, `nproc`) without explaining what they are, and never explains concepts Claude already knows. Matches the 5-anchor 'lean and efficient; every token earns its place'. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is fully executable: specific commands per limiter type ("node --cpu-prof", "py-spy", "strace -c on Linux"), quantitative decision rules ("at least 5 times, alternating", "A gap smaller than the run-to-run variation is no measurable difference", "Removing a piece that takes 10% of the run can make the run at most about 11% faster"), and a copy-ready report sentence. Matches the 5-anchor 'fully executable; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | The sequence is explicit: pre-run steps (write the claim, read the script, check load), the seven numbered validation questions, then a report section with explicit inconclusive criteria and fallback behavior ("If you cannot tune it, do not pick a winner from that run"). The questions are themselves validation checkpoints with error-recovery feedback loops (profile → retune → re-measure), and a fast path for ballpark requests is defined. Matches the 5-anchor 'clear sequence with explicit validation steps; feedback loops'. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, self-contained, and well-sectioned (Before you run anything / The questions / Report / Other perf material), so by the simple-skill note it approaches 5. It drops to 4 because 'Report' and 'Other perf material' depend on external material — "per the **Opening a PR** playbook", "the **Perf issue** playbook", "the **Hillclimb** playbook" — with no paths or links, and no bundle files exist to resolve them; that is a minor navigation gap, matching the 4-anchor 'references mostly clear; minor organization gaps' rather than the 5-anchor's well-signaled references. | 4 / 5 |
Total | 19 / 20 Passed |