Maps business domains and suggests service boundaries in any codebase using DDD Strategic Design. Use when asking "what are the domains in this codebase?", "where should I draw service boundaries?", "identify bounded contexts", "classify subdomains", "DDD analysis", or analyzing domain cohesion. Do NOT use for grouping existing components into domains (use domain-identification-grouping) or dependency analysis (use coupling-analysis).
71
63%
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 ./packages/skills-catalog/skills/(architecture)/domain-analysis/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 hits all the marks. It provides specific DDD-related actions, includes natural trigger phrases users would actually say, explicitly addresses both what and when, and proactively disambiguates from related skills with 'Do NOT use' clauses referencing specific alternative skills by name.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Maps business domains', 'suggests service boundaries', 'classify subdomains', 'identify bounded contexts', and 'analyzing domain cohesion'. These are concrete, well-defined DDD activities. | 3 / 3 |
Completeness | Clearly answers both 'what' (maps business domains, suggests service boundaries using DDD Strategic Design) and 'when' (explicit 'Use when' clause with multiple trigger phrases). Also includes explicit 'Do NOT use' guidance for disambiguation, which goes above and beyond. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms including quoted user phrases ('what are the domains in this codebase?', 'where should I draw service boundaries?'), technical terms ('bounded contexts', 'subdomains', 'DDD analysis'), and conceptual terms ('domain cohesion', 'service boundaries'). | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with explicit negative boundaries ('Do NOT use for grouping existing components into domains' and 'dependency analysis') that directly reference alternative skills by name, making it very unlikely to conflict with related skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
27%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a comprehensive DDD strategic design framework but suffers from extreme verbosity and redundancy. It explains many concepts Claude already understands (bounded contexts, ubiquitous language, integration patterns) and repeats key ideas like the subdomain decision tree. The content would benefit enormously from being split into a concise overview with references to detailed templates and checklists in separate files.
Suggestions
Cut the content by at least 50%: remove DDD concept explanations Claude already knows (bounded context definitions, integration pattern descriptions, anti-patterns), eliminate the duplicate subdomain decision tree, and trim the 'When to Use' section that duplicates the description.
Extract the output format templates, checklists, and quick reference into separate referenced files (e.g., TEMPLATES.md, CHECKLIST.md) to improve progressive disclosure and reduce the monolithic structure.
Add concrete, executable guidance for Phase 1—e.g., specific grep/ripgrep commands to find entities, services, and use cases in common frameworks, rather than just listing naming patterns.
Add explicit validation checkpoints between phases, such as 'Before proceeding to Phase 3, verify each concept group has at least 3 related entities sharing vocabulary' to create feedback loops in the workflow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | This skill is extremely verbose at ~300+ lines, with significant redundancy. The subdomain decision tree appears twice, cohesion concepts are repeated across multiple sections, and much of the content explains DDD concepts Claude already knows (what a bounded context is, what ubiquitous language means, integration pattern definitions). The 'When to Use' section largely duplicates the frontmatter description. | 1 / 3 |
Actionability | The skill provides structured processes and output templates, which is helpful. However, it lacks concrete executable code or commands for actually scanning a codebase—the 'patterns' listed (e.g., `@Entity`, `*Service`) are vague hints rather than grep commands or AST queries. The cohesion scoring formula is a useful concrete artifact, but the overall guidance remains at the conceptual/framework level rather than copy-paste executable. | 2 / 3 |
Workflow Clarity | The six-phase process is clearly sequenced and logically ordered. However, there are no validation checkpoints between phases—no explicit 'verify your Phase 1 output before proceeding' steps, no feedback loops for when analysis reveals ambiguity, and no guidance on what to do when phases produce conflicting signals. For an analytical skill this complex, the lack of verification steps is notable. | 2 / 3 |
Progressive Disclosure | The entire skill is a monolithic wall of text with no references to external files. The output format templates, anti-patterns, checklists, and quick reference sections could all be separate referenced documents. The inline content is overwhelming—the output format section alone is massive and could be a separate TEMPLATES.md file. | 1 / 3 |
Total | 6 / 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.
81e7e0d
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.