Can this skill help me write better unit tests?

Yes. By suggesting port traits for external systems, it enables you to create lightweight mock implementations, allowing you to test complex domain logic without needing a running database or network.

What is Hexagonal Architecture in the context of Rust?

Hexagonal Architecture, or Ports and Adapters, is an architectural pattern that separates core business logic from external concerns using traits (ports) and implementations (adapters), ensuring the domain remains pure and framework-agnostic.

How does the Hexagonal Advisor detect architectural issues?

The skill analyzes your Rust code for specific markers like direct database pool usage in services, infrastructure-specific macros in domain models, or missing trait abstractions for external dependencies.

Does it work with specific Rust web frameworks like Axum or Actix?

The advisor is framework-agnostic but provides patterns for common infrastructure layers, helping you isolate your business logic from whatever web framework or database driver you choose to use.

Rust Hexagonal Architecture Advisor

Name: Rust Hexagonal Architecture Advisor
Author: EmilLindfors

byEmilLindfors

0•

Developer Tools

Guides the implementation of ports and adapters patterns in Rust to ensure clean dependency separation and high testability.

The Hexagonal Architecture Advisor is a specialized skill for Claude Code designed to audit and improve Rust codebases using the Ports and Adapters pattern. It proactively identifies architectural anti-patterns, such as leaking infrastructure details like SQL or HTTP into the domain layer, and provides concrete templates for refactoring. By enforcing strict dependency directions and maintaining pure domain models, this skill helps developers build scalable, framework-agnostic, and easily testable Rust services while providing best-practice implementations for traits, adapters, and composition roots.

Key Features

01Automated architectural audits to detect dependency direction violations

02Code generation for Port traits and Adapter implementation patterns

03Detection of framework-specific leakage in domain models and business logic

040 GitHub stars

05Testing strategy guidance using mock implementations and test doubles

06Composition root analysis to ensure clean dependency injection and wiring

Use Cases

01Improving unit test coverage by isolating domain logic from external side effects

02Migrating from direct database dependencies to abstract repository patterns

03Refactoring monolithic Rust services into decoupled, maintainable architectures

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add emillindfors/claude-marketplace hexagonal-advisor

For use in Claude.ai and ChatGPT

Download Skill