CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

springboot-tdd

Test-driven development for Spring Boot using JUnit 5, Mockito, MockMvc, Testcontainers, and JaCoCo. Use when adding features, fixing bugs, or refactoring.

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/springboot-tdd/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

75%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, actionable single-file skill: executable examples for every test layer, a clear TDD sequence, and disciplined brevity. The main gaps are an undefined TestContainersConfig reference, implicit rather than explicit workflow validation steps, and a length that could benefit from splitting detailed setup content into reference files.

Suggestions

Define or show TestContainersConfig (the @DynamicPropertySource wiring mentioned in the Testcontainers section) since the persistence example imports it but its contents are never given.

Make workflow checkpoints explicit commands, e.g. 'Run mvn test and confirm the new test fails before implementing' and 'Re-run mvn verify to confirm green plus 80% coverage', to add a concrete validation loop.

Consider moving the JaCoCo Maven plugin snippet and Testcontainers wiring into a one-level-deep reference file to keep SKILL.md as a lean overview.

DimensionReasoningScore

Conciseness

The body is lean: short sections, no explanation of concepts Claude already knows, and every code block demonstrates a distinct test layer. Minor trimmable parts remain — the 'When to Use' section duplicates the frontmatter's use cases and the examples carry standard class scaffolding — matching anchor 4 (efficient with minor over-explanation) rather than the every-token-earns-its-place anchor 5.

4 / 5

Actionability

Concrete, executable code for each layer (unit, MockMvc, SpringBootTest, DataJpaTest), a JaCoCo Maven snippet, and CI commands — mostly copy-paste ready. It stops short of anchor 5 because Testcontainers guidance is bullet-only and the persistence example imports 'TestContainersConfig.class' which is never defined, leaving a gap in the common integration-test path.

4 / 5

Workflow Clarity

The TDD workflow is clearly sequenced ('Write tests first (they should fail)' → 'Implement minimal code to pass' → 'Refactor with tests green' → 'Enforce coverage') with checkpoints present as parenthetical conditions. It fits anchor 4 rather than 5 because verification is implicit (no explicit command to confirm red/green, e.g. 'run mvn test and confirm failure') and there is no error-recovery guidance.

4 / 5

Progressive Disclosure

A single-file skill with well-organized, clearly headed sections covering the full testing stack — good structure with content mostly appropriately placed. It does not qualify for the under-50-line simple-skill exception (the body is ~150 lines), and bulkable material like the JaCoCo plugin configuration or Testcontainers setup could live in one-level-deep reference files, keeping it at anchor 4.

4 / 5

Total

16

/

20

Passed

Description

70%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A solid description with a clear what, an explicit Use-when clause, and concrete technology naming. Its main weakness is that it states one action (TDD) plus a tool list rather than enumerating the concrete actions it covers, and its trigger vocabulary could be broadened with natural testing-related phrases.

Suggestions

Replace or supplement the tool list with concrete actions, e.g. 'Write failing tests first, implement minimal code, refactor, and enforce 80% coverage' so the capability set is stated as actions rather than technologies.

Broaden trigger terms to include natural variations users would say, such as 'writing tests', 'unit tests', 'integration tests', or 'test coverage', not just 'adding features, fixing bugs, or refactoring'.

DimensionReasoningScore

Specificity

Names the domain ('Test-driven development for Spring Boot') and an explicit tool stack ('JUnit 5, Mockito, MockMvc, Testcontainers, and JaCoCo'), but the only action stated is 'test-driven development' itself — the enumerated items are tools, not actions. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) rather than anchor 4, which requires several specific action verbs.

3 / 5

Completeness

Both parts are present: a clear 'what' ('Test-driven development for Spring Boot using JUnit 5, Mockito, MockMvc, Testcontainers, and JaCoCo') and an explicit 'Use when adding features, fixing bugs, or refactoring' trigger clause with three concrete triggers. It does not reach anchor 5 because the trigger list is thinner and less varied than the comprehensive good example (no synonyms or additional trigger phrases).

4 / 5

Trigger Term Quality

'Use when adding features, fixing bugs, or refactoring' plus tool names (Spring Boot, JUnit 5, Testcontainers) gives good natural keyword coverage — phrases users would actually say. It falls short of anchor 5 because common variations like 'writing tests', 'unit tests', 'integration tests', or 'test coverage' are missing.

4 / 5

Distinctiveness Conflict Risk

The what-clause carves a clear niche (Spring Boot testing with a specific stack), but the when-clause ('adding features, fixing bugs, or refactoring') is broad enough to overlap with general coding or refactoring skills. This is 'mostly distinct; minor overlap risk with closely related skills' rather than the minimal-conflict anchor 5.

4 / 5

Total

15

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

valeriibeck-star/claude-skills

Path

skills/springboot-tdd/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.