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 concrete actions, comprehensive natural trigger terms, explicit 'Use when' and 'Do NOT use' clauses, and clear differentiation from related skills by naming them directly. The negative boundary guidance is particularly effective for disambiguation in a multi-skill environment.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Maps business domains', 'suggests service boundaries', 'classify subdomains', 'identify bounded contexts', and 'analyzing domain cohesion'. Also specifies the methodology (DDD Strategic Design) and scope ('any codebase').

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). Additionally includes 'Do NOT use' guidance to prevent misselection, which goes above and beyond.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'domains in this codebase', 'service boundaries', 'bounded contexts', 'subdomains', 'DDD analysis', 'domain cohesion'. These are terms a developer would naturally use when needing this skill.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with explicit negative boundaries ('Do NOT use for grouping existing components... or dependency analysis') that reference specific alternative skills by name. The DDD Strategic Design focus and specific trigger terms create a clear niche unlikely to conflict with other 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 is a comprehensive DDD reference document rather than an efficient skill instruction. It over-explains well-known DDD concepts (bounded contexts, subdomain types, integration patterns) that Claude already understands, resulting in extreme verbosity. While the phased analysis process and output templates provide useful structure, the lack of executable tooling commands and the monolithic format significantly reduce its effectiveness as a skill file.

Suggestions

Cut the skill to under 100 lines by removing DDD concept explanations (Core/Supporting/Generic definitions, integration pattern descriptions, anti-patterns) that Claude already knows, keeping only codebase-specific scanning heuristics and the output format.

Move the detailed output format templates and cohesion matrix to a separate TEMPLATES.md file, referencing it from the main skill.

Add concrete, executable guidance for codebase scanning - e.g., specific grep/ripgrep commands to find entities, services, and domain concepts, or file-tree analysis patterns.

Add validation checkpoints between phases, such as 'Before Phase 3, verify each concept is assigned to exactly one language group' and 'After Phase 5, confirm all low-cohesion issues have actionable recommendations.'

DimensionReasoningScore

Conciseness

This skill is extremely verbose at ~300+ lines, explaining DDD concepts Claude already knows well (what bounded contexts are, what subdomains are, integration patterns like Shared Kernel/Anti-corruption Layer). The definitions of Core/Supporting/Generic subdomains, bounded context principles, and integration patterns are standard DDD knowledge that doesn't need re-teaching. Multiple sections repeat the same ideas (decision tree appears twice, cohesion checks are restated in multiple forms).

1 / 3

Actionability

The skill provides structured frameworks (cohesion scoring formula, decision trees, output templates) which give some concrete guidance, but lacks executable code or specific commands for actually scanning a codebase. The analysis process describes what to look for conceptually but doesn't provide concrete grep commands, AST analysis scripts, or tool-specific instructions for extracting concepts from code.

2 / 3

Workflow Clarity

The six-phase process is clearly sequenced and logically ordered, but lacks validation checkpoints between phases. There's no guidance on what to do if Phase 2 groupings are ambiguous, no feedback loops for iterating on boundary decisions, and no explicit verification that the analysis is complete or correct before producing output.

2 / 3

Progressive Disclosure

This is a monolithic wall of text with no references to external files. The output format templates, anti-patterns, best practices, checklists, and quick references are all inline, making this extremely long. The output format section alone could be a separate reference file, and the anti-patterns/best practices sections add significant length for concepts Claude already understands.

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.