Use when you need to implement acceptance tests from a Gherkin .feature file for Spring Boot applications — including finding scenarios tagged @acceptance, implementing happy path tests with TestRestTemplate, @SpringBootTest, Testcontainers with @ServiceConnection for DB/Kafka, and WireMock for external REST stubs. Requires .feature file in context. Part of the skills-for-java project
74
67%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/323-frameworks-spring-boot-testing-acceptance-tests/SKILL.mdQuality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an excellent skill description that clearly communicates its purpose, triggers, and specific capabilities. It uses third person voice appropriately, includes an explicit 'Use when' clause at the start, and provides comprehensive technical trigger terms that developers would naturally use. The description also helpfully notes a prerequisite (.feature file in context) and its project context.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: finding scenarios tagged @acceptance, implementing happy path tests with TestRestTemplate, @SpringBootTest, Testcontainers with @ServiceConnection for DB/Kafka, and WireMock for external REST stubs. | 3 / 3 |
Completeness | Clearly answers both what (implement acceptance tests with specific technologies) AND when ('Use when you need to implement acceptance tests from a Gherkin .feature file') with explicit trigger at the start. Also notes prerequisite: 'Requires .feature file in context.' | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'acceptance tests', 'Gherkin', '.feature file', 'Spring Boot', 'Testcontainers', 'WireMock', 'Kafka', 'TestRestTemplate' - all terms developers naturally use when discussing this domain. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear niche: specifically targets Gherkin-based acceptance testing for Spring Boot with a precise technology stack (Testcontainers, WireMock, TestRestTemplate). Unlikely to conflict with general testing or other framework skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill functions more as an index or pointer to external documentation than a standalone skill. While it correctly identifies the scope and constraints, it lacks any concrete, executable examples that would allow Claude to immediately understand the implementation pattern. The heavy reliance on the external reference file means the skill body itself provides minimal actionable value.
Suggestions
Add a minimal executable example showing a complete acceptance test class with @SpringBootTest, TestRestTemplate, and one Testcontainer - this should be copy-paste ready
Include a concrete example of mapping a Gherkin scenario to a test method with @DisplayName and Given-When-Then comments
Show a specific WireMock stub example inline rather than just mentioning it conceptually
Reduce the 'What is covered' bullet list to only items that aren't obvious from the title, or remove it entirely and use that space for examples
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some redundancy - the 'What is covered' section largely repeats information that could be inferred from the title and description. The bullet list format is good but could be tighter. | 2 / 3 |
Actionability | The skill provides no executable code examples, no concrete commands beyond generic Maven invocations, and no actual implementation patterns. It describes what to do conceptually but delegates all concrete guidance to an external reference file. | 1 / 3 |
Workflow Clarity | The constraints section provides a clear sequence (compile -> apply -> verify) with validation checkpoints, but the actual test implementation workflow is absent - it just says 'see reference' for the detailed steps of implementing tests. | 2 / 3 |
Progressive Disclosure | The skill appropriately references an external file for detailed examples, but the SKILL.md itself is too thin - it's essentially a table of contents with no quick-start content. The overview should include at least one minimal executable example before pointing to the reference. | 2 / 3 |
Total | 7 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
7772a1b
Table of Contents
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.