CtrlK
BlogDocsLog inGet started
Tessl Logo

spring-boot-patterns

Spring Boot best practices and patterns. Use when creating controllers, services, repositories, or when user asks about Spring Boot architecture, REST APIs, exception handling, or JPA patterns.

82

Quality

77%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./.claude/skills/spring-boot-patterns/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

89%

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 a solid skill description with excellent trigger terms and completeness. It explicitly states when to use the skill and includes framework-specific terminology that distinguishes it from generic Java or web development skills. The main weakness is that it describes the domain rather than listing specific concrete actions the skill enables.

Suggestions

Add specific concrete actions like 'Implements REST controllers, configures dependency injection, designs entity relationships, handles exceptions with @ControllerAdvice' to improve specificity.

DimensionReasoningScore

Specificity

Names the domain (Spring Boot) and mentions specific components (controllers, services, repositories) and concepts (REST APIs, exception handling, JPA patterns), but doesn't list concrete actions like 'create REST endpoints' or 'implement repository patterns'.

2 / 3

Completeness

Clearly answers both what ('Spring Boot best practices and patterns') and when ('Use when creating controllers, services, repositories, or when user asks about Spring Boot architecture, REST APIs, exception handling, or JPA patterns') with explicit trigger guidance.

3 / 3

Trigger Term Quality

Includes natural keywords users would say: 'Spring Boot', 'controllers', 'services', 'repositories', 'REST APIs', 'exception handling', 'JPA patterns', 'architecture' - these are terms developers naturally use when seeking Spring Boot guidance.

3 / 3

Distinctiveness Conflict Risk

Clearly scoped to Spring Boot specifically with distinct triggers like 'JPA patterns', 'Spring Boot architecture', and Spring-specific components - unlikely to conflict with generic Java or other framework skills.

3 / 3

Total

11

/

12

Passed

Implementation

64%

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

This is a solid Spring Boot reference skill with excellent actionable code examples covering controllers, services, repositories, DTOs, exception handling, and testing. The main weaknesses are verbosity (includes explanations Claude doesn't need) and lack of progressive disclosure - the content would benefit from being split into focused sub-documents with clear navigation.

Suggestions

Remove explanatory content Claude already knows (e.g., 'GET=read, POST=create' table, basic annotation descriptions) to improve conciseness

Split into multiple files: keep SKILL.md as overview with links to TESTING.md, CONFIGURATION.md, EXCEPTION_HANDLING.md for detailed patterns

Add a workflow section with explicit steps for common tasks like 'Adding a new entity endpoint' with validation checkpoints

DimensionReasoningScore

Conciseness

The skill is comprehensive but includes some content Claude already knows (basic explanations of HTTP methods, what annotations do). The quick reference tables and annotation explanations add bulk that an experienced developer wouldn't need.

2 / 3

Actionability

Excellent executable code examples throughout - complete controller, service, repository, DTO, exception handler, and test templates that are copy-paste ready. Includes both positive patterns and anti-patterns with concrete examples.

3 / 3

Workflow Clarity

The skill presents patterns well but lacks explicit workflow sequencing for setting up a new Spring Boot project or adding features. No validation checkpoints or feedback loops for common operations like database migrations or configuration changes.

2 / 3

Progressive Disclosure

Content is well-organized with clear sections and headers, but it's a monolithic document (~400 lines) that could benefit from splitting into separate files (e.g., TESTING.md, CONFIGURATION.md). No references to external detailed documentation.

2 / 3

Total

9

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
piomin/claude-ai-spring-boot
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.