Skip to content
Back to search

clean-architecture-skills

SkillGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nathankim0--clean-architecture-skills/badge.svg)](/listings/nathankim0--clean-architecture-skills)

HTML

<a href="/listings/nathankim0--clean-architecture-skills"><img src="/api/listings/nathankim0--clean-architecture-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

Run inside Claude Code. Install either plugin or both:

/plugin marketplace add nathankim0/clean-architecture-skills
/plugin install clean-architecture@clean-architecture-skills
/plugin install kent-beck-style@clean-architecture-skills

OpenAI Codex

Run in your terminal:

codex plugin marketplace add nathankim0/clean-architecture-skills
codex plugin add clean-architecture@clean-architecture-skills
codex plugin add kent-beck-style@clean-architecture-skills

Start a new Codex session. Use `/plugins` to browse the marketplace. For the IDE extension or a version without `codex plugin`, use [manual installation](#manual-installation).

Windows plugin installs require [Git symlink support](https://gitforwindows.org/symbolic-links): enable Developer Mode or symlink privileges and clone with `core.symlinks=true`. If symlinks are unavailable, use manual skill-directory installation.

**Using another agent?** Jump to [pi](#pi), [OpenClaw](#openclaw), [GitHub Copilot / Amp](#github-copilot-and-amp), or [manual installation](#manual-installation).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 25 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "clean-architecture-skills",
  3. "owner": {
  4. "name": "Community",
  5. "url": "https://github.com/anthropics/skills"
  6. },
  7. "metadata": {
  8. "description": "Clean Architecture and Kent Beck refactoring skills for code review, architecture design, and simple design.",
  9. "version": "1.6.3"
  10. },
  11. "plugins": [
  12. {
  13. "name": "clean-architecture",
  14. "source": "./plugins/clean-architecture",
  15. "description": "Review and design code using Clean Architecture, the Dependency Rule, layer boundaries, and SOLID principles.",
  16. "version": "1.3.0"
  17. },
  18. {
  19. "name": "kent-beck-style",
  20. "source": "./plugins/kent-beck-style",
  21. "description": "Review and refactor code using Kent Beck's simple design principles, code smell detection, and incremental improvements.",
  22. "version": "1.1.1"
  23. }
  24. ]
  25. }
README.md · README · 266 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img width="2171" height="724" alt="Clean Architecture Skills — architecture review and refactoring guidance for AI coding agents" src="https://github.com/user-attachments/assets/e0b26116-97c8-4062-b323-ad7239f66006" />
  3. # Clean Architecture Skills
  4. **Clear boundaries. Simple code.**
  5. Two skills for AI coding agents: review architecture, spot code smells, and improve code in small steps.
  6. [![Release](https://img.shields.io/github/v/release/nathankim0/clean-architecture-skills?style=flat-square&color=2563eb)](https://github.com/nathankim0/clean-architecture-skills/releases) [![Validation](https://img.shields.io/github/actions/workflow/status/nathankim0/clean-architecture-skills/validate.yml?branch=main&label=checks&style=flat-square)](https://github.com/nathankim0/clean-architecture-skills/actions/workflows/validate.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-2563eb?style=flat-square)](LICENSE)
  7. English · [한국어](README.ko.md)
  8. [Skills](#skills) · [Quick start](#quick-start) · [Usage](#usage) · [Supported agents](#supported-agents) · [Contributing](#contributing)
  9. </div>
  10. > [!IMPORTANT]
  11. > **Architecture matters more, not less, when AI writes the code.**
  12. > AI agents produce code faster than anyone can review it, and they copy whatever structure they find. Clear boundaries tell an agent where a change belongs, keep its mistakes inside one layer, and let you swap a fake for a real backend by editing one file. Without them, every prompt adds a shortcut that the next prompt repeats.
  13. ## Skills
  14. | Skill | What it helps with |
  15. | --- | --- |
  16. | **[Clean Architecture](plugins/clean-architecture/skills/clean-architecture/SKILL.md)** | Review dependency direction, layer boundaries, and SOLID. Keep business rules independent of infrastructure. |
  17. | **[Kent Beck Style](plugins/kent-beck-style/skills/kent-beck-style/SKILL.md)** | Find code smells, clarify names, and simplify code through small, behavior-preserving refactorings. |
  18. Use either skill independently, or combine them to review the design and then simplify the implementation. Each is a portable `SKILL.md` file; the same instructions are shared across agents.
  19. ## Quick start
  20. ### Claude Code
  21. Run inside Claude Code. Install either plugin or both:
  22. ```text
  23. /plugin marketplace add nathankim0/clean-architecture-skills
  24. /plugin install clean-architecture@clean-architecture-skills
  25. /plugin install kent-beck-style@clean-architecture-skills
  26. ```
  27. ### OpenAI Codex
  28. Run in your terminal:
  29. ```bash
  30. codex plugin marketplace add nathankim0/clean-architecture-skills
  31. codex plugin add clean-architecture@clean-architecture-skills
  32. codex plugin add kent-beck-style@clean-architecture-skills
  33. ```
  34. Start a new Codex session. Use `/plugins` to browse the marketplace. For the IDE extension or a version without `codex plugin`, use [manual installation](#manual-installation).
  35. Windows plugin installs require [Git symlink support](https://gitforwindows.org/symbolic-links): enable Developer Mode or symlink privileges and clone with `core.symlinks=true`. If symlinks are unavailable, use manual skill-directory installation.
  36. **Using another agent?** Jump to [pi](#pi), [OpenClaw](#openclaw), [GitHub Copilot / Amp](#github-copilot-and-amp), or [manual installation](#manual-installation).
  37. ## Usage
  38. After installation, ask your agent to use a skill in a regular prompt:
  39. ```text
  40. Use clean-architecture to review the dependencies in src/domain.
  41. Point out violations and explain why each boundary matters.
  42. ```
  43. ```text
  44. Use kent-beck-style to review this module.
  45. Suggest small refactorings that preserve behavior and make the intent clearer.
  46. ```
  47. For a combined review:
  48. ```text
  49. Review this feature with clean-architecture and kent-beck-style.
  50. Check the dependency direction, then suggest the smallest changes
  51. that would make the code easier to understand and maintain.
  52. ```
  53. You can also ask for a new feature design, review YAGNI and KISS, improve names, or refactor a long method.
  54. <details>
  55. <summary><strong>Explicit skill selection in Codex and pi</strong></summary>
  56. In Codex, open `/skills` or mention an installed plugin skill directly:
  57. ```text
  58. $clean-architecture:clean-architecture Review the dependencies in src/domain.
  59. $kent-beck-style:kent-beck-style Review this module for code smells and small refactorings.
  60. ```
  61. In pi, invoke `/skill:clean-architecture` or `/skill:kent-beck-style`.
  62. </details>
  63. ## Supported agents
  64. | Agent | Installation |
  65. | --- | --- |
  66. | **Claude Code** | [Native plugin marketplace](#quick-start) |
  67. | **OpenAI Codex** | [Native plugin marketplace](#quick-start) or [shared skills directory](#manual-installation) |
  68. | **pi** | [Git package](#pi) |
  69. | **OpenClaw** | [Skills CLI](#openclaw) |
  70. | **GitHub Copilot** | [GitHub CLI](#github-copilot-and-amp) or [shared skills directory](#manual-installation) |
  71. | **Amp** | [GitHub CLI](#github-copilot-and-amp) or [shared skills directory](#manual-installation) |
  72. | **Cursor** | [Local skills directory](#manual-installation) |
  73. | **Gemini CLI** | [Local skills directory](#manual-installation) |
  74. | **OpenCode** | [Local skills directory](#manual-installation) |
  75. Choose one installation method per agent to avoid duplicate skills.
  76. <a id="pi"></a>
  77. <details>
  78. <summary><strong>pi</strong> — install as a Git package</summary>
  79. ```bash
  80. pi install git:github.com/nathankim0/clean-architecture-skills
  81. ```
  82. Run `/reload` in an active session, then invoke `/skill:clean-architecture` or `/skill:kent-beck-style`. Check installed packages with `pi list`.
  83. To install a local clone instead, run `pi install .` from the repository root.
  84. </details>
  85. <a id="openclaw"></a>
  86. <details>
  87. <summary><strong>OpenClaw</strong> — install with the Skills CLI</summary>
  88. Clone the repository and install either or both skills on the machine running your OpenClaw Gateway:
  89. ```bash
  90. git clone https://github.com/nathankim0/clean-architecture-skills.git
  91. cd clean-architecture-skills
  92. openclaw skills install ./plugins/clean-architecture/skills/clean-architecture --global
  93. openclaw skills install ./plugins/kent-beck-style/skills/kent-beck-style --global
  94. openclaw skills list --eligible
  95. ```
  96. Start a new session after installation. The installer copies the skill folders; after `git pull`, repeat the install commands with `--force` to update them.
  97. </details>
  98. <a id="github-copilot-and-amp"></a>
  99. <details>
  100. <summary><strong>GitHub Copilot / Amp</strong> — install with GitHub CLI</summary>
  101. From the Git repository where you want to use the skills, choose the command for your agent:
  102. ```bash
  103. # GitHub Copilot
  104. gh skill install nathankim0/clean-architecture-skills --all --agent github-copilot --scope project
  105. # Amp
  106. gh skill install nathankim0/clean-architecture-skills --all --agent amp --scope project
  107. ```
  108. Both commands install into `.agents/skills/`, so one installation covers both agents in the same project. Check with `gh skill list --scope project`, then start a new session and ask your agent to use `clean-architecture` or `kent-beck-style`.
  109. Use `copilot skill list` or `amp skill list` to check discovery in each configured client.
  110. For Copilot cloud agent and Copilot code review, commit the installed `.agents/skills/` folders to the target repository. For a personal installation, replace `--scope project` with `--scope user`.
  111. If your GitHub CLI does not include `gh skill`, use [manual installation](#manual-installation).
  112. </details>
  113. <a id="manual-installation"></a>
  114. <details>
  115. <summary><strong>Manual installation</strong> — shared directory and other agents</summary>
  116. Clone the repository, then link either or both skills into `~/.agents/skills/`. Codex, GitHub Copilot, Amp, and pi can discover this shared directory.
  117. The commands below use a macOS or Linux shell:
  118. ```bash
  119. git clone https://github.com/nathankim0/clean-architecture-skills.git
  120. cd clean-architecture-skills
  121. mkdir -p ~/.agents/skills
  122. ln -s "$PWD/plugins/clean-architecture/skills/clean-architecture" ~/.agents/skills/
  123. ln -s "$PWD/plugins/kent-beck-style/skills/kent-beck-style" ~/.agents/skills/
  124. ```
  125. For project-only use, link or copy the skill folders into the target project's `.agents/skills/` instead. On Windows, copy the folders into your agent's skills directory, or create directory links using your shell's equivalent commands.
  126. Reload or restart your agent if the skills do not appear. Keep the clone at the same path so the links remain valid. Run `git pull` to update linked skills; copied folders must be copied again after updates. If a skill is already installed, move the old folder aside before creating its link.
  127. For other agents, link or copy the **individual skill folders containing `SKILL.md`** into the appropriate directory:
  128. | Agent | Skills directory |
  129. | --- | --- |
  130. | Cursor | `.cursor/skills/` in the target project |
  131. | Gemini CLI | `~/.gemini/skills/` |
  132. | OpenCode | `~/.config/opencode/skills/` |
  133. | OpenClaw | `~/.openclaw/skills/` (default shared managed directory) |
  134. | pi | `~/.pi/agent/skills/` |
  135. | GitHub Copilot | `.agents/skills/` (project) or `~/.copilot/skills/` (personal) |
  136. | Amp | `.agents/skills/` (project) or `~/.config/agents/skills/` (personal) |
  137. OpenClaw also discovers `~/.agents/skills/` with its default state directory. For a custom state directory, use its [Skills CLI](#openclaw).
  138. </details>
  139. ## The approach
  140. ### Dependencies point inward
  141. **Keep business rules independent.** Source-code dependencies point inward, toward higher-level policies:
  142. ![Clean Architecture: four concentric layers with dependencies pointing inward. DIP: the use case uses an inner repository port, and an outer DB adapter implements that port; both code dependencies point to the port.](docs/images/clean-architecture.png)
  143. The circles show nested boundaries. Arrows represent source-code dependencies, not execution order. Dependencies can skip layers while keeping this direction. Neither a circular drawing nor exactly four layers is required; the dependency rule is. See [Robert C. Martin's original explanation](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html).
  144. ### Dependency inversion (DIP)
  145. **High-level policies and low-level details depend on abstractions; those abstractions do not depend on implementation details.** As shown on the right of the image, define the port (interface) in the inner layer that needs it, and make the outer adapter implement it.
  146. For example, `GetUserUseCase` references only `UserRepository`; the outer `PostgresUserRepository` implements that port. At runtime, the use case calls the supplied implementation through the port. This is how calls can go outward while source-code dependencies stay inward. Dependency injection (DI) supplies the implementation; injection alone does not satisfy DIP if the use case still depends on the concrete class.
  147. ### Small refactorings
  148. **Improve code in small steps.** Follow Kent Beck's simple design priorities: pass the tests, reveal intention, avoid duplication, and keep unnecessary elements out. Use abstractions when they solve a real problem.
  149. The [Clean Architecture skill](plugins/clean-architecture/skills/clean-architecture/SKILL.md) and [Kent Beck Style skill](plugins/kent-beck-style/skills/kent-beck-style/SKILL.md) contain the full review checklists, report formats, and TypeScript, Python, and Java/Kotlin examples.
  150. ## Contributing
  151. Issues and pull requests are welcome, especially concrete review examples, clearer guidance, and verified agent installation fixes.
  152. - Edit the shared instructions in `plugins/<name>/skills/<name>/SKILL.md`.
  153. - Edit each plugin's `.codex-plugin/plugin.json` as the single manifest source. `.claude-plugin/plugin.json` is a relative symlink to it. The marketplace catalogs stay separate because their schemas differ.
  154. - Keep the English and Korean READMEs in sync.
  155. Run the checks with **Node.js 24 or later**; no dependencies need to be installed:
  156. ```bash
  157. node --test
  158. ```
  159. GitHub Actions checks plugin metadata and executable skill examples on Linux and Windows.
  160. ## References
  161. - [The Clean Architecture — Robert C. Martin](https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html)
  162. - [Refactoring and the Refactoring Catalog — Martin Fowler](https://refactoring.com/)
  163. - [Implementation Patterns — Kent Beck](https://www.amazon.com/Implementation-Patterns-Kent-Beck/dp/0321413091)
  164. <details>
  165. <summary><strong>Official agent documentation</strong></summary>
  166. | Agent | Documentation |
  167. | --- | --- |
  168. | Claude Code | [Plugin marketplaces](https://code.claude.com/docs/en/plugin-marketplaces) |
  169. | OpenAI Codex | [Skills](https://developers.openai.com/codex/skills/) · [Plugin packaging](https://developers.openai.com/plugins/build/plugins) |
  170. | pi | [Skills](https://pi.dev/docs/latest/skills) · [Packages](https://pi.dev/docs/latest/packages) |
  171. | OpenClaw | [Skills](https://docs.openclaw.ai/tools/skills) · [Skills CLI](https://docs.openclaw.ai/cli/skills) |
  172. | GitHub Copilot | [Agent Skills](https://docs.github.com/en/copilot/concepts/agents/about-agent-skills) · [GitHub CLI installation](https://cli.github.com/manual/gh_skill_install) |
  173. | Amp | [Skills](https://ampcode.com/docs/customize/skills) |
  174. </details>
  175. ## License
  176. [MIT](LICENSE) — use, modify, and share.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.