Content
77%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.
The skill is well-structured with a clear, validated workflow and clean sectioning, but the central BUILD step lacks an executable test example, which limits actionability.
Suggestions
Add a short copy-paste-ready MockK + runTest example in the BUILD step showing the Arrange-Act-Assert structure and a sentence-like test name.
Trim the 'Philosophy' bullets to remove truisms Claude already knows (e.g., 'Untested code is broken code') to save tokens.
Show one concrete Before/After test-name example pair to make the descriptive naming guidance executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes Claude's competence, but 'Philosophy' bullet truisms ('Untested code is broken code') and some restated guidance add minor padding that could be trimmed. | 4 / 5 |
Actionability | It gives concrete commands (./gradlew ktfmtFormat, testDebugUnitTest) and patterns, but the actual test-writing step offers no executable code example — only descriptive test names and patterns, leaving the core action under-specified. | 3 / 5 |
Workflow Clarity | The SCAN→SELECT→BUILD→VERIFY→PRESENT sequence is explicit, includes an approval checkpoint, formatting/test verification steps, and a mutation-testing feedback loop, satisfying validation for a code-writing workflow. | 5 / 5 |
Progressive Disclosure | No bundle files exist and none are needed; the body is well-organized into Goal/Constraints/Instructions/Examples sections, fitting the simple-skill exception for progressive disclosure. | 5 / 5 |
Total | 17 / 20 Passed |