CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

clean-architecture

Provides implementation patterns for Clean Architecture, Hexagonal Architecture (Ports & Adapters), and Domain-Driven Design in Java 21+ Spring Boot 3.5+ applications. Use when structuring layered architectures, separating domain logic from frameworks, implementing ports and adapters, creating entities/value objects/aggregates, or refactoring monolithic codebases for testability and maintainability.

67

Quality

84%

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

SKILL.md
Quality
Evals
Security

Quality

Content

67%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, highly actionable guide with concrete examples spanning all layers and real supporting reference files. Its main costs are token redundancy (best practices stated twice, a concept primer Claude doesn't need) and examples with minor completeness gaps, plus validation guidance that is a final section rather than explicit checkpoints in the workflow.

Suggestions

Merge the 'Apply Best Practices' list (§7) and the 'Best Practices' section into one list, and cut the §1 primer explaining entities/value objects/aggregates that Claude already knows — this alone would remove significant duplication.

Fix example completeness: define or annotate OrderMapper/mapItems/createRequest as intentionally elided, and make the OrderTest's 'new Money("10.00", EUR)' call match the Money record's (BigDecimal, Currency) constructor.

Move the Java-specific pattern details (records, factory methods, strongly-typed IDs) fully into references/java-clean-architecture.md and link to it from the relevant body sections, keeping SKILL.md as a lean overview with one representative end-to-end example.

DimensionReasoningScore

Conciseness

The body is mostly useful but carries clear redundancy: the 'Apply Best Practices' list (§7) and the 'Best Practices' section near the end repeat the same 8-10 principles nearly verbatim, and §1 explains concepts Claude already knows (what entities, value objects, aggregates, and the dependency rule are). It fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') rather than anchor 4, where over-explanation would be only minor.

3 / 5

Actionability

Eight concrete, near-executable Java examples cover every layer (domain entity, value object, port, service, JPA adapter, REST controller, tests), matching anchor 4 ('mostly executable guidance with minor gaps'). It falls short of anchor 5 because examples reference undefined helpers (OrderMapper, mapItems, createRequest) and the test's 'new Money("10.00", EUR)' doesn't match the Money record's (BigDecimal, Currency) signature.

4 / 5

Workflow Clarity

A clear numbered sequence (concepts → package structure → domain → application → infrastructure → adapter → best practices → tests) with per-layer test guidance in step 8 serving as verification, matching anchor 4. Not anchor 5 because validation is not woven in as explicit checkpoints (e.g., no 'verify domain has zero Spring imports' or dependency-check step) and there is no error-recovery feedback loop.

4 / 5

Progressive Disclosure

Two real, one-level-deep reference files (references/java-clean-architecture.md, references/spring-boot-implementation.md) are clearly signaled with content descriptions, and the body is well-sectioned — matching anchor 4. It is not anchor 5 because ~180 lines of inlined code examples plus Java-record patterns (duplicated in java-clean-architecture.md) arguably belong in the reference files, and references are only surfaced at the very end rather than from the relevant sections.

4 / 5

Total

15

/

20

Passed

Description

95%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 strong description that clearly states what the skill does and when to use it, with concrete trigger phrases and good synonym coverage. The only mild weakness is that the leading capability statement ('Provides implementation patterns for') is more abstract than the specific action list that follows.

DimensionReasoningScore

Specificity

The 'Use when' clause lists several concrete actions ('structuring layered architectures, separating domain logic from frameworks, implementing ports and adapters, creating entities/value objects/aggregates, or refactoring monolithic codebases'), but the core 'what' statement ('Provides implementation patterns for') is somewhat generic, keeping it just below the comprehensive anchor 5.

4 / 5

Completeness

Explicitly answers both 'what' ('Provides implementation patterns for Clean Architecture, Hexagonal Architecture (Ports & Adapters), and Domain-Driven Design in Java 21+ Spring Boot 3.5+ applications') and 'when' ('Use when structuring..., separating..., implementing..., creating..., or refactoring...') with concrete trigger phrases, matching the anchor 5 example structure. Not anchor 4 because the 'when' clause is already fully explicit and specific.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage including the key synonym expansion ('Hexagonal Architecture (Ports & Adapters)'), plus 'Clean Architecture', 'Domain-Driven Design', 'layered architectures', 'entities/value objects/aggregates', and 'Spring Boot' — phrases a user would naturally say when needing this skill. It is above anchor 4 because no meaningful natural variation for this domain is missing.

5 / 5

Distinctiveness Conflict Risk

Clear niche (architecture patterns for Java 21+ Spring Boot 3.5+) with distinct, specific triggers ('ports and adapters', 'DDD aggregate design', 'hexagonal architecture Spring Boot'); overlap risk with generic Java/Spring skills is minimal given the version and pattern specificity.

5 / 5

Total

19

/

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

allowed_tools_field

'allowed-tools' contains unusual tool name(s)

Warning

Total

15

/

16

Passed

Repository

fernandezbaptiste/developer-kit

Path

plugins/developer-kit-java/skills/clean-architecture/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.