CtrlK
BlogDocsLog inGet started
Tessl Logo

quarkus-ddd

Scaffold and generate Domain-Driven Design components with Hexagonal Architecture in Quarkus projects. Use this skill whenever the user wants to create a new bounded context, add an aggregate, create value objects, scaffold a DDD module, add a new subdomain, or generate any DDD tactical pattern (aggregate, entity, value object, command, event, repository, service, endpoint) in a Quarkus/Java project. Also trigger when the user mentions 'hexagonal architecture', 'ports and adapters', or asks to add a new feature following DDD patterns.

70

Quality

85%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

70%

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

This skill is highly actionable with excellent workflow clarity — the generation order, naming conventions, dependency rules, and complete code examples make it very clear what Claude should produce. However, it suffers from being a monolithic document (~300+ lines of inline code) that would benefit significantly from splitting templates and testing guidance into separate files. The DDD quotes on nearly every class and some explanatory text add token overhead without proportional value.

Suggestions

Extract the 11 code templates into a separate TEMPLATES.md or individual template files, keeping only the package structure, naming table, and generation order in SKILL.md as an overview

Remove the DDD book quotes from code comments — Claude doesn't need authoritative citations to generate correct code, and they consume tokens on every generation

Move the Testing section to a separate TESTING.md file referenced from the main skill

Remove explanatory phrases like 'DTOs are not specifically a DDD concept' and 'The application has a semantically sound interaction...' — these don't change Claude's behavior

DimensionReasoningScore

Conciseness

The skill is quite long (~300+ lines) with extensive code examples for every single layer. The DDD quotes on nearly every class, while thematic, consume tokens without adding actionable value for Claude. Some sections like the DTO explanation ('DTOs are not specifically a DDD concept') are unnecessary. However, the code examples themselves are lean and the naming table is efficient.

2 / 3

Actionability

Every layer has fully executable, copy-paste-ready Java code with correct package declarations, imports, and annotations. The naming conventions table, package structure, and generation order provide extremely concrete guidance. The Kafka configuration properties are included. This is highly actionable.

3 / 3

Workflow Clarity

The generation order (steps 1-11) is clearly sequenced with domain-first, adapters-last ordering. The application service section explicitly specifies critical ordering (persist then publish, never inside transaction). The 'Getting Started' section provides a clear information-gathering checklist before generation begins, and offers two workflow paths (full scaffolding vs layer-by-layer).

3 / 3

Progressive Disclosure

This is a monolithic wall of content with no references to external files. All 11 layers with full code examples are inline in a single file. The persistence layer alone has three separate class examples. This content would benefit enormously from splitting code templates into separate referenced files (e.g., TEMPLATES.md, TESTING.md) with the SKILL.md serving as an overview.

1 / 3

Total

9

/

12

Passed

Description

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 defines its scope, lists concrete actions and tactical patterns, and provides explicit trigger guidance with both a 'Use this skill whenever...' clause and an 'Also trigger when...' clause. The description is comprehensive yet focused on a distinct niche (DDD + Hexagonal Architecture + Quarkus), making it highly distinguishable from other skills. It uses proper third-person voice throughout.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: scaffold bounded contexts, add aggregates, create value objects, scaffold DDD modules, add subdomains, and generate tactical patterns (aggregate, entity, value object, command, event, repository, service, endpoint).

3 / 3

Completeness

Clearly answers both 'what' (scaffold and generate DDD components with Hexagonal Architecture in Quarkus projects) and 'when' (explicit 'Use this skill whenever...' clause with detailed trigger scenarios, plus an 'Also trigger when...' clause for additional triggers).

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'bounded context', 'aggregate', 'value object', 'DDD module', 'subdomain', 'hexagonal architecture', 'ports and adapters', 'DDD patterns', 'Quarkus', 'Java', plus specific tactical pattern names like 'command', 'event', 'repository', 'service', 'endpoint'.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive niche combining DDD tactical patterns, hexagonal architecture, and Quarkus/Java specifically. Unlikely to conflict with generic code generation or other architecture skills due to the very specific domain and technology stack.

3 / 3

Total

12

/

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
jeremyrdavis/claude-skills-for-quarkus
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.