Clean Architecture Reviewer
An architecture skill that audits your layers, boundaries and SOLID usage against the Dependency Rule and prescribes concrete inversions.
Dev & CodingIntermediate★ 1,984⑂ 198AI score 7/10Last updated: Aug 10, 2026
What it does
- Audits the Dependency Rule: checks that source dependencies point inward only (frameworks → use cases → entities) and names the exact inversion needed for each violation.
- Decides where code belongs: Entity, Use Case, Interface Adapter, or Framework/Driver.
- 7-row diagnostic with a score: questions like "can you test business rules without a DB or web server?" and "is the component graph cycle-free?" map to a 0–10 band plus fixes for every failed row.
- Component principles and SOLID: REP/CCP/CRP/ADP/SDP/SAP and SRP·OCP·LSP·ISP·DIP with concrete code patterns.
- Common-mistake catalog: ORM leaking into domain logic, business rules in controllers, framework-first design, distributed monoliths.
Who it's for
- Backend/fullstack developers laying out module boundaries for a new service
- Teams incrementally decoupling legacy code from a framework or ORM
- Tech leads who repeatedly answer "which layer should this live in?" during review
- Anyone turning hexagonal (ports & adapters) or onion architecture into real code
Example uses
- "All my payment logic sits in the controller — how do I extract it?" → get a
PlaceOrderInteractorwith input/output ports and a controller reduced to translate-and-delegate. - "Review my project's architecture" → a score across the seven diagnostics plus an ordered fix list (missing repository interface, dependency cycle, etc.).
- "I want to swap Postgres without touching business rules" → an
OrderRepositoryinterface owned by the use case layer withSqlOrderRepositoryin adapters.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/wondelai/skills/HEAD/clean-architecture/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the clean-architecture folder from the GitHub repo wondelai/skills into my ~/.claude/skills/clean-architecture/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/wondelai/skills.git /tmp/wondelai-skills && mkdir -p ~/.claude/skills && cp -r /tmp/wondelai-skills/clean-architecture ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the skills repo:
git clone https://github.com/wondelai/skills.git - Create the skills directory if needed:
mkdir -p ~/.claude/skills - Copy the whole skill folder so the
references/docs come along:cp -r skills/clean-architecture ~/.claude/skills/ - Verify with
ls ~/.claude/skills/clean-architecture— you should seeSKILL.mdandreferences/. - Restart Claude Code and try a prompt like "Audit this project's layers against Clean Architecture" — the skill triggers automatically.
View source on GitHub ↗License: MIT