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 strong, well-structured process skill: an explicit TDD workflow with validation loops and checklists, concrete testing protocols, and disciplined use of one-level-deep references. The only weaknesses are minor — a duplicated background block, no inline worked test example, and a couple of second-level or external reference hops.
Suggestions
Deduplicate the "REQUIRED BACKGROUND" block (stated once in the Overview and again nearly verbatim before "The Iron Law") into a single pointer.
Inline one short worked example of a baseline pressure scenario or sample subagent prompt so the core testing loop is copy-paste ready without opening the reference.
Guard the ../using-superpowers/references/ cross-skill links with a fallback (or note they apply only when that skill is installed), since they do not resolve in a standalone bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Dense, high-signal tables, checklists, and concrete rules with no explanation of concepts Claude already knows. Minor trimmable redundancy: the "REQUIRED BACKGROUND" block appears nearly verbatim twice (Overview and Iron Law sections), and the test-first mandate is restated across the Overview, Iron Law, rationalizations table, STOP section, and checklist. | 4 / 5 |
Actionability | Highly concrete and executable for an instruction skill: TDD mapping table, a numbered micro-test protocol ("5+ reps per variant", "Always include a no-guidance control"), the failure-to-form matching table, a per-phase checklist, and the script-invocation rule ("bash scripts/tool.sh"). Minor gap: no inline worked example of a pressure scenario or sample baseline subagent prompt — that is delegated to references/testing-skills-with-subagents.md. | 4 / 5 |
Workflow Clarity | The RED-GREEN-REFACTOR cycle is explicitly sequenced with validation checkpoints (baseline run without the skill, verification run with the skill, re-test until bulletproof), feedback loops for error recovery, and a mandatory per-skill deployment checklist — a direct match for the anchor-5 pattern. No destructive or batch operations apply, so no cap is triggered. | 5 / 5 |
Progressive Disclosure | All five SKILL.md references (anthropic-best-practices.md, discovery.md, flowcharts.md, bulletproofing.md, testing-skills-with-subagents.md) are real files, one level deep, each with an explicit when-to-read condition, and heavy material (the 1150-line best-practices file) is correctly externalized at 399 body lines. Minor gaps: two references chain to a second level (flowcharts.md → graphviz-conventions.dot; bulletproofing.md → persuasion-principles.md), and the cross-skill links to ../using-superpowers/references/ point outside the bundle and may not resolve. | 4 / 5 |
Total | 17 / 20 Passed |