omaromar9091

Clean Architecture Skill — Productivity skill for Claude Code

Productivity community

A calibrated Claude Skill for Clean Architecture, SOLID, and component decoupling — scaled to task size, backed by real multi-language code examples, and honest about the compromises real frameworks f.

How to install Clean Architecture Skill

This entry records only its repository, not the path inside it, so there is no exact command to give. Open omaromar9091/clean-architecture-skill and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Clean Architecture Skill does

Alternatives in Productivity

Reviews Plans — Review all active architecture plans relevant to the current task 15.6k ★
Project Management Skills — Project management frameworks and tools 5.3k ★
Tradingview MCP — Real-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick p 2.6k ★

README

Clean Architecture Skill for Claude

A production-ready [Claude Skill](https://docs.claude.com) that teaches Claude to apply Robert C. Martin's **Clean Architecture**, **SOLID principles**, and **component-decoupling** rules — correctly calibrated to the size of the task, backed by real multi-language code, and honest about the compromises real-world frameworks force.

Drop it into your skills directory and Claude will automatically reach for it whenever you're designing a feature, reviewing code for architectural soundness, deciding which layer a piece of logic belongs in, or untangling a legacy codebase.

Quick install (one command)

Run this from the root of any project. It downloads the skill and places it at `.claude/skills/clean-architecture/`, where Claude Code and other Claude-based agents pick up skills automatically — no manual copying needed.

**macOS / Linux:**

curl -fsSL https://raw.githubusercontent.com/omaromar9091/clean-architecture-skill/main/install.sh | bash

**Windows (PowerShell):**

iwr -useb https://raw.githubusercontent.com/omaromar9091/clean-architecture-skill/main/install.ps1 | iex

Prefer to inspect a script before running it? Open [`install.sh`](install.sh) or [`install.ps1`](install.ps1) first — both just download `SKILL.md` and the `references/` files into your project, nothing else.

For manual installation (copying the folder yourself, or using this with a non-Claude tool), see [Installation](#installation) below.

Why this exists

Most "Clean Architecture" prompts and cheat sheets have the same problem: they describe the *theory* well but fall apart in practice. They tell an AI agent to enforce four concentric layers on every single request — including a one-line bug fix — which produces exactly the kind of bureaucratic over-engineering Clean Architecture was invented to prevent. They also tend to skip the parts that actually come up in real projects: how do errors cross layer boundaries