Clean Architecture Skills plugin
Two skills for architecture review and small safe refactorings: layer boundaries, SOLID and code smells in Kent Beck's manner.
- 113 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The skills give recommendations and code edits on request and perform no external actions.
Install
- Works in
Manual install
/plugin marketplace add nathankim0/clean-architecture-skillsThe Claude Code command from the README, followed by installing the plugins `clean-architecture@clean-architecture-skills` and `kent-beck-style@clean-architecture-skills`.
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skills give recommendations and code edits on request and perform no external actions.
This is third-party code. Review the repository files before installing.
What it does
The plugin holds two independent skills. Clean Architecture checks dependency direction, layer boundaries and SOLID and keeps business rules independent of infrastructure. Kent Beck Style finds code smells, clarifies names and simplifies the implementation in small steps while preserving behavior. The skills work separately or together: architecture review first, then implementation cleanup. Each skill is a portable `SKILL.md`, so the instructions are the same for Claude Code, Codex and other agents. The repository carries marketplace manifests for Claude Code and Codex.
Who it is for. Lead developers and maintainers whose agent copies whatever structure it finds and adds another shortcut with every prompt.
Good fit when
- Before merging a large change, check whether the domain depends on the database.
- A module has accumulated tangled names and long functions that should be cleaned in small steps.
- A new feature is designed so swapping a fake for a real backend touches one file.
- Agent code has grown suspiciously and code smells must be found.
Not a fit when
- The project is tiny and layer separation would add extra code.
- You need a security or performance review.
- The team follows another architectural school without clean architecture.
Example request
Review the orders module against clean architecture: where the domain depends on infrastructure, and propose the first safe step.Limitations
The skills give guidance on principles rather than checking code automatically, so decisions on layer boundaries stay with a person. Clean architecture does not suit every project and adds extra layers in small apps. Refactorings run in small steps, and without tests behavior preservation cannot be guaranteed. The plugins install from a marketplace with separate commands for Claude Code and Codex, and Codex needs a new session after install. The resulting changes still have to be read before merging.
How to disable. Remove the plugins through the agent's plugin manager: `/plugin` in Claude Code or `/plugins` in Codex.
FAQ
Can I install just one skill?
Yes. `clean-architecture` and `kent-beck-style` install independently, each with its own command.
How do the skills differ?
The first looks at structure: dependencies, layers, SOLID. The second works on code inside a layer: names, smells and small refactorings.
How do I install in Codex?
`codex plugin marketplace add nathankim0/clean-architecture-skills`, then `codex plugin add clean-architecture@clean-architecture-skills`. Start a new session afterward.
Does it fit other agents?
The skills are portable `SKILL.md` files and can be wired by hand into agents that support the format.
Is there a Korean version?
The repository has a Korean README. The skill instructions themselves are in English.
Discussion
No questions or reviews yet.
Related
Pluginslencx skills
lencx-skills
Two skills for Claude Code and Codex: keel works through architecture questions, coding-protocol keeps code edits inside the task
A skills library for Claude Code, Cursor and Codex: team code review, TDD, stacked PRs and repository readiness scoring
An architecture coach skill: questions lead to ADRs, a diagram and a plan, and a repository is audited from its code
Skills for Claude Code and other agents: spec pushback, six-specialist branch review, architecture and accessibility audits
kyy-logs code-review-skill
code-review-skill
A code review skill with four independent probes, evidence-backed findings and a merge gate derived from JSON
A Claude Code plugin that interviews you, designs the architecture and writes a self-contained blueprint to build from
README in short
Explains why architecture matters when an agent writes code, lists the two skills and gives install commands for Claude Code and Codex.