Content
70%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
Well-structured overview with strong workflow validation and clean progressive disclosure to a real reference file. Weaker on conciseness (duplicated trigger list) and actionability (no inline executable code, abstract workflow verbs).
Suggestions
Remove or condense the 'When to use this skill' section, since its five bullets duplicate the trigger phrases already in the frontmatter description; keep a single source of truth for triggers.
Add one short inline good-vs-bad code example (e.g., @ExtendWith(MockitoExtension.class) service test vs. an unnecessary @SpringBootTest) in the body so guidance is executable without opening the reference.
Tighten workflow step 3 from 'Implement or refactor configuration/code following the reference patterns' to a concrete instruction naming the specific pattern to apply for the detected test type.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean and avoids lecturing on concepts Claude already knows, but the 'When to use this skill' section repeats the same five trigger phrases already in the frontmatter description and the @322 redirect is duplicated, so it could be tightened. | 2 / 3 |
Actionability | Concrete commands (./mvnw compile, mvn clean verify) and specific annotations are present, but the body defers all executable code/good-bad examples to the reference file and workflow step 3 ('Implement or refactor configuration/code following the reference patterns') is abstract rather than copy-paste ready. | 2 / 3 |
Workflow Clarity | The four-step workflow is clearly sequenced with explicit validation checkpoints and feedback loops: MANDATORY compile before changes, SAFETY stop-on-failure, and VERIFY clean verify afterward. | 3 / 3 |
Progressive Disclosure | A concise overview body with a single, clearly signaled one-level-deep reference (references/321-frameworks-spring-boot-testing-unit-tests.md, which exists) holding the detailed rules and good/bad examples, with the reference linked both in the workflow and a dedicated Reference section. | 3 / 3 |
Total | 10 / 12 Passed |