Content
92%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 exceptionally tight, well-structured principles skill: every section is a specific, directive rule set, the TDD cycle provides an explicitly validated workflow, and the single-file organization is appropriate for its size. The only improvement surface is adding one or two brief worked examples (e.g., a sample test name or table-driven case) to lift actionability to fully concrete.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive — dense one-line rules such as 'RED: confirm the new test fails for the intended reason. GREEN: implement the smallest passing change.' with zero padding and no explanation of concepts Claude already knows. Every token carries guidance, matching the 'lean and efficient; every token earns its place' anchor; it is not a 4 because there are no trimmable over-explanations anywhere. | 5 / 5 |
Actionability | Concrete, executable directives are present throughout — 'Add a regression test for every reproducible behavior bug fix', 'Mock direct external I/O boundaries; keep internal business logic and the boundary under test real', 'Structure each test as Arrange, one Act, and Assert'. It is not a 5 because, per the instruction-only scoring note, fully actionable guidance for common cases would include at least one worked example (e.g., a named test or a table-driven case); it is above a 3 because the guidance is specific and directly executable, not pseudocode or high-level hints. | 4 / 5 |
Workflow Clarity | The TDD section is a clearly sequenced cycle with explicit validation checkpoints and feedback loops: RED ('confirm the new test fails for the intended reason' — a failure-reason check), GREEN, REFACTOR ('while the test remains green'), and VERIFY ('run the repository's applicable regression checks'). The refactor path adds a precondition loop ('first confirm existing tests pass... then refactor and rerun the same regression evidence'), matching the anchor-5 sequence-with-explicit-validation pattern. | 5 / 5 |
Progressive Disclosure | At ~52 lines with eight well-organized sections (TDD, Quality Requirements, Test Design Rules, Mock and Boundary Rules, Data Layer Testing, Verification Requirements, Test Organization, Regression Testing), no external references are needed and none are buried — the simple-skill case where well-organized sections alone warrant a 5. No bundle files exist, so there are no nested or buried references to penalize. | 5 / 5 |
Total | 19 / 20 Passed |