Finds duplicate business logic spread across multiple components and suggests consolidation. Use when asking "where is this logic duplicated?", "find common code between services", "what can be consolidated?", "detect shared domain logic", or analyzing component overlap before refactoring. Do NOT use for code-level duplication detection (use linters) or dependency analysis (use coupling-analysis).
66
58%
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)/component-common-domain-detection/SKILL.mdQuality
Discovery
89%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 a strong skill description that clearly defines its purpose, provides rich natural-language trigger terms, and explicitly delineates its boundaries with 'Do NOT use' exclusions. The only minor weakness is that the capability description could be slightly more specific about concrete outputs or actions beyond 'finds' and 'suggests consolidation'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (duplicate business logic across components) and the core action (finds duplicates and suggests consolidation), but it doesn't list multiple concrete actions beyond 'finds' and 'suggests consolidation' — it could be more specific about what consolidation looks like or what outputs are produced. | 2 / 3 |
Completeness | Clearly answers both 'what' (finds duplicate business logic across components and suggests consolidation) and 'when' (explicit 'Use when' clause with multiple trigger phrases, plus 'Do NOT use' exclusions that further clarify scope). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger phrases: 'where is this logic duplicated?', 'find common code between services', 'what can be consolidated?', 'detect shared domain logic', 'component overlap', and 'refactoring' are all terms users would naturally use. The negative triggers also help clarify boundaries. | 3 / 3 |
Distinctiveness Conflict Risk | The description carves out a clear niche by specifying 'business logic' duplication across 'components/services' and explicitly excludes code-level duplication detection (linters) and dependency/coupling analysis, making it highly distinguishable from related skills. | 3 / 3 |
Total | 11 / 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 extremely verbose and repetitive, explaining the same notification/audit consolidation example across nearly every section. While the analysis framework (5 phases, coupling assessment, consolidation approaches) is logically sound, the content would benefit enormously from being condensed to ~25% of its current size and splitting detailed examples and code into referenced files. The skill over-explains concepts Claude already understands (what shared libraries are, domain vs infrastructure distinctions) while under-delivering on executable, copy-paste-ready tooling.
Suggestions
Reduce content by 60-75%: eliminate repeated examples (notification/audit pattern appears 8+ times), remove explanations of basic concepts (shared libraries, coupling), and consolidate redundant sections (Core Concepts and Analysis Process overlap significantly).
Split into multiple files: move Implementation Notes (per-language patterns), Fitness Functions, and detailed Output Format templates into separate referenced files, keeping SKILL.md as a concise overview with the 5-phase process.
Add explicit validation checkpoints in the workflow: e.g., 'Before recommending consolidation, verify findings by checking at least 2 source files in each identified group to confirm actual duplication, not just naming similarity.'
Make the Usage Examples section actionable by showing actual commands or tool invocations Claude should use (e.g., grep/ripgrep commands to find namespace patterns, specific file analysis steps) rather than just describing what 'the skill will do.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~400+ lines. Extensively explains concepts Claude already knows (domain vs infrastructure, what shared libraries are, what coupling means). Massive amounts of repetition—the same notification/audit/validation examples are repeated across nearly every section. The output format examples, analysis process, and implementation notes all re-explain the same concepts with slight variations. | 1 / 3 |
Actionability | Provides some concrete code snippets (namespace detection, shared class detection functions) and structured output formats, but much of the content is descriptive rather than executable. The 'Usage Examples' section just describes what the skill 'will do' rather than showing how to actually perform the analysis. The code examples are helper functions but lack a complete, end-to-end executable workflow. | 2 / 3 |
Workflow Clarity | The 5-phase process is clearly sequenced and the steps are logical. However, there are no explicit validation checkpoints or error recovery steps. For an analysis that could lead to destructive refactoring (consolidation), there's no verification step to confirm findings before acting on recommendations. The checklist at the end partially compensates but is a post-hoc review rather than inline validation. | 2 / 3 |
Progressive Disclosure | This is a monolithic wall of text with no references to external files. Content that should be in separate files (detailed output format templates, implementation notes per language, fitness functions, code examples) is all inline. The document tries to be both an overview and a complete reference, resulting in an overwhelming single file that's difficult to navigate. | 1 / 3 |
Total | 6 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
skill_md_line_count | SKILL.md is long (607 lines); consider splitting into references/ and linking | Warning |
Total | 10 / 11 Passed | |
906a57d
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.