CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

architecture-patterns

Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design. Use this skill when designing clean architecture for a new microservice, when refactoring a monolith to use bounded contexts, when implementing hexagonal or onion architecture patterns, or when debugging dependency cycles between application layers.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

72%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body excels at executable guidance (complete in-memory adapter tests) and diagnosis (six symptom→fix troubleshooting entries), and its two-tier reference structure is correctly implemented with real bundle files. The weaknesses are the Core Concepts section re-teaching architecture knowledge Claude already has, and the absence of a sequenced workflow for the primary task of architecting a service.

Suggestions

Cut the Core Concepts section to a compact rules-only summary (dependencies point inward; ports are abstract, adapters concrete; aggregates are consistency boundaries) and move the pattern definitions into references/details.md — Claude already knows Clean/Hexagonal/DDD terminology, so ~45 lines of the body spend tokens on known material.

Add a numbered 'Architecting a service' workflow with validation checkpoints (1. identify the bounded context and ubiquitous language, 2. define entities and value objects with invariants in the constructor, 3. define ports in domain/interfaces, 4. implement adapters, 5. write use-case tests with in-memory adapters, 6. verify use_cases/ imports only from domain/) so the primary task has an explicit sequence instead of purely topical organization.

Make the details.md pointer a markdown link like the advanced-patterns one and merge it into a single 'References' section for consistent navigation signaling.

DimensionReasoningScore

Conciseness

The Testing and Troubleshooting sections are tight and earn their tokens, but the ~45-line Core Concepts section re-explains textbook material Claude already knows ("Value Objects: Immutable objects identified by their attributes", the four Clean Architecture rings, ports vs adapters), and the opening line "Master proven backend architecture patterns... to build maintainable, testable, and scalable systems" is padding. This fits anchor 3 ("mostly efficient but includes some unnecessary explanation or could be tightened") — the over-explanation is a real chunk of the body, more than anchor 4's "minor instances".

3 / 5

Actionability

The Testing section provides fully executable, copy-paste-ready code (a complete InMemoryUserRepository plus two use-case tests), and Troubleshooting gives concrete remedies for six common failure modes ("Enforce the rule: use_cases/ imports only from domain/", "map to/from the domain entity in the repository's _to_entity() method", "Validate invariants in __post_init__"). This matches anchor 5 — executable examples covering the common cases; anchor 4 would require gaps in the code or the failure-mode coverage, which are not present.

5 / 5

Workflow Clarity

The skill is organized topically (concepts, testing, troubleshooting) rather than procedurally — there is no sequenced workflow for the primary task of architecting a service (e.g., identify bounded context → define entities/value objects → define ports → implement adapters → verify with in-memory tests). Validation exists implicitly (use-case tests as the hallmark of correct layering) but checkpoints are not sequenced, fitting anchor 3 ("sequence present but checkpoints missing or implicit") rather than 4, which requires a clear sequence with most checkpoints present.

3 / 5

Progressive Disclosure

The body is a genuine overview tier with two well-signaled, one-level-deep references that both exist in the bundle: "Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient" and "For detailed DDD bounded context mapping, full multi-service project trees, Anti-Corruption Layer implementations, and Onion Architecture comparisons, see: references/advanced-patterns.md". Content is appropriately split (summary and troubleshooting inline; directory trees and deep-dives in references), matching anchor 5's clear overview with easy navigation.

5 / 5

Total

16

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description that clearly states what the skill does and when to use it, with concrete, natural trigger phrases covering the domain's vocabulary including synonyms (hexagonal/onion, monolith/bounded contexts). The only weakness is minor overlap risk with closely related skills (microservices-patterns, DDD-specific skills) on the new-microservice trigger.

DimensionReasoningScore

Specificity

"Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design" names multiple concrete capabilities, and the when-clause adds four more specific actions (designing a microservice, refactoring a monolith to bounded contexts, implementing hexagonal/onion patterns, debugging dependency cycles). This matches the anchor for multiple specific concrete actions with comprehensive coverage; score 4 would require minor gaps, but each named pattern and scenario is a distinct, concrete capability.

5 / 5

Completeness

It explicitly answers both questions: what ("Implement proven backend architecture patterns including Clean Architecture, Hexagonal Architecture, and Domain-Driven Design") and when ("Use this skill when designing clean architecture for a new microservice, when refactoring a monolith to use bounded contexts... or when debugging dependency cycles between application layers"). This matches anchor 5 exactly — concrete trigger phrases accompany both what and when; anchor 4 would require the when-clause to be less explicit.

5 / 5

Trigger Term Quality

The description covers the natural vocabulary of this domain comprehensively, including synonyms: "Clean Architecture", "Hexagonal Architecture", "onion architecture", "Domain-Driven Design", "microservice", "refactoring a monolith", "bounded contexts", "dependency cycles" — all phrases a user would naturally say when needing this skill. Only trivial omissions (the "DDD" acronym, "ports and adapters") keep this from being beyond anchor 5, which it otherwise fits better than anchor 4's "a few natural terms missing".

5 / 5

Distinctiveness Conflict Risk

The niche is clear (backend layering/architecture patterns with distinct triggers like "dependency cycles" and "bounded contexts"), but "designing clean architecture for a new microservice" overlaps with the closely related microservices-patterns skill referenced in the body. This fits anchor 4 ("mostly distinct; minor overlap risk with closely related skills") rather than 5, since the Related Skills section itself acknowledges adjacent skills that could claim the microservice-design trigger.

4 / 5

Total

19

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

wshobson/agents

Path

plugins/backend-development/skills/architecture-patterns/SKILL.md

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.