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.
91
88%
Does it follow best practices?
Impact
95%
1.75xAverage score across 3 eval scenarios
Passed
No known issues
Quality
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 articulates specific capabilities (scaffolding DDD components), provides comprehensive trigger conditions with natural terminology, and carves out a distinct niche combining DDD, Hexagonal Architecture, and Quarkus. The description uses proper third-person voice and balances technical precision with accessibility.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'create a new bounded context', 'add an aggregate', 'create value objects', 'scaffold a DDD module', 'add a new subdomain', and 'generate any DDD tactical pattern' with explicit examples (aggregate, entity, value object, command, event, repository, service, endpoint). | 3 / 3 |
Completeness | Clearly answers both what ('Scaffold and generate Domain-Driven Design components with Hexagonal Architecture in Quarkus projects') AND when ('Use this skill whenever...') with explicit, comprehensive trigger conditions covering multiple scenarios. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'bounded context', 'aggregate', 'value objects', 'DDD module', 'subdomain', 'hexagonal architecture', 'ports and adapters', 'DDD patterns', 'Quarkus/Java project'. These are terms domain experts and developers would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with a clear niche: DDD + Hexagonal Architecture + Quarkus/Java. The combination of these specific architectural patterns and technology stack makes it unlikely to conflict with generic code generation or other architecture skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, highly actionable skill with excellent workflow clarity and comprehensive code examples for DDD/Hexagonal Architecture in Quarkus. The main weaknesses are moderate verbosity (repeated Javadoc instructions, some explanatory text Claude doesn't need) and the monolithic structure that could benefit from progressive disclosure via linked reference files.
Suggestions
Extract the detailed code templates (sections 1-11) into a separate TEMPLATES.md or REFERENCE.md file, keeping SKILL.md as a concise overview with links
Remove the repeated Javadoc quote instructions - specify once that domain classes should include canonical DDD quotes, then provide a separate quotes reference
Trim explanatory phrases like 'Key rules:' and 'Critical ordering:' - use formatting (bold, numbered lists) to convey importance without extra words
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is comprehensive but includes some unnecessary verbosity, such as repeated Javadoc quote instructions and explanations Claude would infer. The extensive code examples are valuable but could be more condensed in places. | 2 / 3 |
Actionability | Excellent actionability with fully executable Java code examples, specific package structures, complete class templates, and copy-paste ready implementations for every component type. | 3 / 3 |
Workflow Clarity | Clear 11-step generation order with explicit sequencing (domain first, adapters last), critical ordering notes for the service layer (persist then publish), and explicit layer dependency rules that serve as validation checkpoints. | 3 / 3 |
Progressive Disclosure | Content is well-organized with clear sections and tables, but it's a monolithic document (~300 lines) that could benefit from splitting detailed code templates into separate reference files while keeping SKILL.md as an overview. | 2 / 3 |
Total | 10 / 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.
506591e
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.