CtrlK
BlogDocsLog inGet started
Tessl Logo

domain-analysis

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

Quality

63%

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 ./packages/skills-catalog/skills/(architecture)/domain-analysis/SKILL.md
SKILL.md
Quality
Evals
Security

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 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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
tech-leads-club/agent-skills
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.