Content
81%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 highly actionable, well-sequenced workflow skill: every step has executable commands, explicit validation, and error-recovery paths, and the report format is enforced with concrete grep checks. Its main weakness is verbosity — the shape-check rules are repeated several times — and its length sits entirely in one file rather than being split across a reference bundle.
Suggestions
State the five-heading shape check and the banned-heading list once (e.g. in the 'Report shape' section) and reference it from Steps 0 and 4 instead of repeating the full rule three times — this would cut roughly 20 lines without losing the constraint.
Trim the rhetorical framing (e.g. 'a run that leaves a differently-shaped file has produced nothing, however good the audit inside it', 'and that is the one way this run fails outright') down to their single operative instruction, since the commands and checks already enforce the behavior.
Move the 'Finding format' and 'Report shape' sections into a references/ file (e.g. REPORT-FORMAT.md) and keep a short inline template plus a clearly signaled link, so the step-by-step workflow in SKILL.md stays lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient instruction with no explanation of concepts Claude already knows, but it repeats itself: the five-heading shape check appears three times (Step 0, mid-Step 4, and the final check section), the banned-heading list ("## Summary", "## Verdict", "## Scope and method", "## Bottom line") is stated twice nearly verbatim, and passages like "a run that leaves a differently-shaped file has produced nothing, however good the audit inside it" are rhetorical padding. It is above level 2 because every section still carries real, non-generic instruction rather than padded explanation. | 3 / 5 |
Actionability | Guidance is fully executable and copy-paste ready: the `cat > TEST-REVIEW.md <<'EOF'` skeleton, `bun run --cwd <workspace-path> build` / `test:run` commands, the `ls`/`find` test-layout resolution, exact `grep -c` validation commands, and an exact four-field finding template. It matches the level-5 anchor — concrete commands and examples cover the common cases, exceeding level 4's 'minor gaps'. | 5 / 5 |
Workflow Clarity | Steps 0–4 are explicitly sequenced with built-in validation checkpoints (`grep -c '^## ...'` must print 5, checked as soon as the first gap is written and again before finishing) and feedback loops (restore the five headings and re-edit; "No step is a stop" — a failing build or test is recorded under `## Not run` and the run continues). This matches the level-5 anchor with both explicit validation and error-recovery loops. | 5 / 5 |
Progressive Disclosure | The single SKILL.md is well-sectioned with clear headers, and its two external pointers (`wiki/conventions/testing-patterns.md`, `wiki/conventions/browser-tests.md`) are one level deep and clearly signaled in context. It is not level 5 because at ~207 lines it is a monolithic file with no bundle — the finding-format and report-shape detail could live in a reference file; it is above level 3 because structure and signaling are good and nothing is buried. | 4 / 5 |
Total | 17 / 20 Passed |