architecture-patterns
Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use when architecting complex backend systems or refactoring existing applications for better maintainability.
Install with Tessl CLI
npx tessl i github:secondsky/claude-skills --skill architecture-patternsOverall
score
72%
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
67%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 description has good structure with explicit 'what' and 'when' clauses, and names specific architecture patterns. However, it lacks concrete action verbs describing deliverables and misses common trigger term variations that users might naturally use when seeking architecture guidance.
Suggestions
Add more concrete actions like 'define bounded contexts', 'create layer boundaries', 'structure dependency injection', 'separate domain from infrastructure'
Include common trigger term variations: 'DDD', 'ports and adapters', 'onion architecture', 'code organization', 'separation of concerns', 'layered architecture'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (backend architecture) and lists specific patterns (Clean Architecture, Hexagonal Architecture, DDD), but doesn't describe concrete actions beyond 'implement' and 'refactoring' - lacks specific deliverables like 'create layer boundaries', 'define domain models', or 'structure dependency injection'. | 2 / 3 |
Completeness | Clearly answers both what ('Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design') and when ('Use when architecting complex backend systems or refactoring existing applications for better maintainability') with explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Includes some relevant terms like 'Clean Architecture', 'Hexagonal Architecture', 'Domain-Driven Design', 'backend systems', and 'refactoring', but misses common variations users might say like 'ports and adapters', 'onion architecture', 'DDD', 'layered architecture', 'separation of concerns', or 'code organization'. | 2 / 3 |
Distinctiveness Conflict Risk | Reasonably specific to architecture patterns, but 'backend systems' and 'refactoring' are broad terms that could overlap with general coding skills or other backend-focused skills. The specific pattern names help distinguish it, but the scope could still conflict with general software design skills. | 2 / 3 |
Total | 9 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill provides excellent, executable code examples demonstrating Clean Architecture, Hexagonal Architecture, and DDD patterns in Python. However, it's verbose with explanatory content Claude already knows, lacks clear implementation workflows with validation steps, and could benefit from better progressive disclosure by splitting detailed implementations into separate reference files.
Suggestions
Remove or significantly condense the 'When to Use This Skill' and 'Core Concepts' sections - Claude already understands these architectural patterns
Add a clear step-by-step workflow for implementing these patterns in a new project or refactoring an existing one, with validation checkpoints
Split detailed code examples into separate reference files (e.g., CLEAN_ARCHITECTURE.md, HEXAGONAL.md, DDD.md) and keep SKILL.md as a concise overview with navigation
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill includes some unnecessary explanatory content (e.g., 'When to Use This Skill' section with 7 bullet points, 'Core Concepts' section explaining what Clean Architecture/Hexagonal/DDD are). Claude already knows these architectural patterns; the skill should focus on project-specific conventions or executable patterns. | 2 / 3 |
Actionability | Provides fully executable Python code examples with complete implementations including entities, repositories, use cases, and adapters. Code is copy-paste ready with proper imports and realistic implementations. | 3 / 3 |
Workflow Clarity | The skill presents patterns and code examples but lacks clear step-by-step workflows for implementing these architectures. No validation checkpoints or sequence for migrating existing code or setting up new projects. Best Practices and Common Pitfalls are listed but not integrated into actionable workflows. | 2 / 3 |
Progressive Disclosure | Content is reasonably organized with clear sections, but it's a monolithic document with no references to external files for detailed patterns. The 200+ lines could benefit from splitting detailed implementations into separate reference files while keeping SKILL.md as an overview. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
87%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 14 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata' field is not a dictionary | Warning |
license_field | 'license' field is missing | Warning |
Total | 14 / 16 Passed | |
- 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.