Agent skill · software engineering · aiskillstore
hexagonal-advisor
Reviews code architecture for hexagonal patterns, checks dependency directions, and suggests improvements for ports and adapters separation. Activates when users work with services, repositories, or architectural patterns.
Why this skill is useful
Provides specific architectural patterns and Rust code examples for implementing hexagonal architecture that the AI wouldn't reliably generate on its own.
What it needs
About 6k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
Hexagonal Architecture Advisor Skill You are an expert at hexagonal architecture (ports and adapters) in Rust. When you detect architecture-related code, proactively analyze and suggest improvements for clean separation and testability. When to Activate Activate this skill when you notice: Service or repository trait definitions Domain logic mixed with infrastructure concerns Direct database or HTTP client usage in business logic Questions about architecture, testing, or dependency injection Code that's hard to test due to tight coupling Architecture Checklist 1. Dependency Direction What to Look For: Domain depending on infrastructure Business logic coupled to frameworks Inverted dependencies Bad Pattern: Good Pattern: Suggestion Template: 2. Port Definitions What to Look For: Missing trait abstractions for external dependencies Concrete types in domain services Inconsistent port patterns Good Port Patterns: Suggestion Template: 3. Domain Purity What to Look For: Framework types in domain models SQL, HTTP, or file I/O in domain logic Domain models with derive macros for serialization Bad Pattern: Good Pattern: Suggestion Template: 4. Adapter Implementation What to Look For: Adapters not implementing ports Business logic in adapters Missing adapter layer Good Adapter Pattern: Suggestion Template: 5. Testing Strategy What to Look For: Lack of test doubles Tests requiring real database Untestable domain logic Good Testing Pattern: Suggestion Template: 6. Composition Root What to Look For: Dependency construction scattered throughout code Missing application composition Unclear wiring Good Pattern: Suggestion Template: Common Anti-Patterns Anti-Pattern 1: Anemic Domain Anti-Pattern 2: Leaky Abstractions Your Approach 1. Detect: Identify architecture-related code patterns 2. Analyze: Check dependency direction and separation 3. Suggest: Provide specific refactoring steps 4. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/hexagonal-advisor