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 well-crafted, highly actionable skill body: the soundness-vs-completeness-vs-correctness framing, hard read-first gates, the nine failure-named lenses, and the ranked finding schema give Claude everything needed to execute. The only deductions are minor — some repetition of the findings-not-edits principle and a 128-line single file where lens details could be split into a reference.
Suggestions
State the 'findings, not edits' principle once (ideally in the intro) and let the Non-goals section carry the variants, cutting the repetition in Steps 3 and 5.
Consider moving the nine lens definitions (Step 2) into a references/lenses.md with a one-line summary per lens in SKILL.md, shortening the always-loaded overview while keeping the details one level deep.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense craft guidance with no concept padding — e.g., the nine lenses each carry a named question plus the failure they catch, knowledge Claude does not already have. However, the "findings, not edits" principle is repeated four times ("You produce findings, not edits" in the intro, "A finding with no evidence pointer is an opinion" in Step 3, "Never edit the design under review" in Step 5, "Not a rewrite" in Non-goals), and a few rhetorical flourishes ("spends the author's trust on partial understanding") could be trimmed — minor over-explanation, not the lean-every-token-earns-its-place level. | 4 / 5 |
Actionability | Guidance is fully executable: copy-paste commands ("exec(\"cat proposals/0003-feature.md\")", "exec(\"grep -rln <subsystem-keyword> decisions/\")", "write({ document: { path: \"proposals/0003-feature-review.md\" } })"), concrete file-path patterns, and a complete finding schema (Claim / Evidence / Severity with three defined levels / Resolution) with example resolutions ("consider a two-way-door version that does X, which drops the migration"). As an instruction-only skill, the guidance is specific and actionable throughout. | 5 / 5 |
Workflow Clarity | Steps 0–6 are clearly sequenced with explicit validation gates: "never review a design you have not read end to end", "Do not proceed until you can name the goal, the constraints, and the prior decisions", and Step 1's stop condition ("If you cannot state the goal... the reviewable object does not exist yet — and that IS the finding"). Step 4 adds an explicit adversarial feedback loop — re-read each finding and try to kill it — which is a genuine validate-and-retry checkpoint on the review itself. | 5 / 5 |
Progressive Disclosure | The file is well-organized with clear section headers (Steps 0–6, Non-goals) and no external references to navigate, so structure is good. But at ~128 lines with the nine-lens catalog (Step 2) and knowledge-base navigation details inlined, it exceeds the under-50-line self-contained case; the lens definitions could live in a one-level-deep reference file for a tighter overview. Minor organization gap rather than a monolith — hence 4, not 3. | 4 / 5 |
Total | 18 / 20 Passed |