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.
An exemplary instruction-only skill: dense with project-specific judgment, fully executable commands, and a validation-first workflow whose checkpoints directly encode the lessons of two past wrong findings. The only structural note is that everything lives inline in SKILL.md with external documentation referenced but not bundled.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section carries non-obvious, project-specific knowledge — past wrong findings, the median/mean skew numbers (3.6M vs 15.4M), the `explore_share` null caveat — with no padding and no explanation of concepts Claude already knows. The two anecdote paragraphs earn their tokens by encoding exactly how prior analyses failed. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout: `bun run --cwd tools/pr-metrics report -- --coverage`, `--waste`, `--json`, and the `gh pr diff … --patch | grep -E …` dependency-bump check, plus concrete output requirements for the written answer. | 5 / 5 |
Workflow Clarity | Clear sequence (Step 0 coverage → Step 1 run what you need → Step 2 report) with explicit checkpoints: read and write down three coverage facts before continuing, exclude `null`-edit cards and report the exclusion count, state unrated data at the top, and seek a discriminator before accepting a correlation. This is an analysis skill, so the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | Well-organized self-contained sections with clearly signaled external pointers (`tools/pr-metrics/README.md`, `wiki/observability/session-metrics.md`, `queries.sql`, the `retro`/`pick-agent` skills) in a dedicated "What consumes this" section. It scores below 5 because the ~120-line body inlines all operational detail with no bundle split, and sibling-skill pointers are names rather than paths. | 4 / 5 |
Total | 19 / 20 Passed |