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 content is highly actionable with a clear, validated TDD workflow, but it is a long monolithic file that inlines reference material a separate file would carry, and it includes some basic TDD explanation Claude does not need.
Suggestions
Move the matcher catalog, full spec-style examples, and property-generator reference into a references/ file (e.g., references/kotest-reference.md) and link to it from a concise SKILL.md overview.
Trim the RED-GREEN-REFACTOR explainer box and the closing "Tests are documentation" prose, which restate concepts Claude already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dominated by useful executable code, but the RED-GREEN-REFACTOR explainer box and the opening/closing prose restate TDD basics Claude already knows, so it could be tightened. | 3 / 5 |
Actionability | It provides fully executable, copy-paste-ready Kotlin code and concrete gradle commands (./gradlew test, koverHtmlReport) covering spec styles, mocking, coroutines, property testing, and coverage. | 5 / 5 |
Workflow Clarity | The 7-step "How It Works" and the TDD walkthrough give a clear sequence with explicit validation checkpoints (verify FAIL, verify PASS, confirm 80%+ coverage) and a built-in RED/GREEN/REFACTOR feedback loop. | 5 / 5 |
Progressive Disclosure | Section headers and a Quick Reference with anchor links give reasonable structure, but no bundle files exist and large reference-style content (matchers, all spec styles, property generators) is fully inlined in one ~820-line file. | 3 / 5 |
Total | 16 / 20 Passed |