Vercel Composition Patterns
supabase/supabase
React composition patterns that scale. An agent skill from supabase/supabase.
Clean Architecture principles and best practices from Robert C.
Install Clean Architecture
$ npx skills add GabrielMartinMoran/mind --skill clean-architecture -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install GabrielMartinMoran/mind clean-architecture --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/GabrielMartinMoran/mind.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/clean-architecture .claude/skills/clean-architecture && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "clean-architecture" agent skill from https://github.com/GabrielMartinMoran/mind/tree/main/.agents/skills/clean-architecture into .claude/skills/clean-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "clean-architecture", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/GabrielMartinMoran/mind/tree/main/.agents/skills/clean-architectureType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add GabrielMartinMoran/mind --skill clean-architecture -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install GabrielMartinMoran/mind clean-architecture --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GabrielMartinMoran/mind.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/clean-architecture .agents/skills/clean-architecture && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "clean-architecture" agent skill from https://github.com/GabrielMartinMoran/mind/tree/main/.agents/skills/clean-architecture into .agents/skills/clean-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "clean-architecture", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add GabrielMartinMoran/mind --skill clean-architecture -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install GabrielMartinMoran/mind clean-architecture --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GabrielMartinMoran/mind.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/clean-architecture .cursor/skills/clean-architecture && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "clean-architecture" agent skill from https://github.com/GabrielMartinMoran/mind/tree/main/.agents/skills/clean-architecture into .cursor/skills/clean-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "clean-architecture", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/GabrielMartinMoran/mind.git --path .agents/skills/clean-architecture--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add GabrielMartinMoran/mind --skill clean-architecture -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install GabrielMartinMoran/mind clean-architecture --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GabrielMartinMoran/mind.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/clean-architecture .gemini/skills/clean-architecture && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "clean-architecture" agent skill from https://github.com/GabrielMartinMoran/mind/tree/main/.agents/skills/clean-architecture into .gemini/skills/clean-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "clean-architecture", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install GabrielMartinMoran/mind clean-architectureInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add GabrielMartinMoran/mind --skill clean-architecture -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/GabrielMartinMoran/mind.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/clean-architecture .github/skills/clean-architecture && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "clean-architecture" agent skill from https://github.com/GabrielMartinMoran/mind/tree/main/.agents/skills/clean-architecture into .github/skills/clean-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "clean-architecture", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add GabrielMartinMoran/mind --skill clean-architecture -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install GabrielMartinMoran/mind clean-architecture --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GabrielMartinMoran/mind.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/clean-architecture .opencode/skills/clean-architecture && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "clean-architecture" agent skill from https://github.com/GabrielMartinMoran/mind/tree/main/.agents/skills/clean-architecture into .opencode/skills/clean-architecture/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "clean-architecture", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
clean-architecture- GitHub stars
- 148
- Used in
- 1 other repo
- Token cost
- ~1.9k tokens
- SKILL.md length
- 510 words
- Files
- 45 (incl. references, assets)
- Skills in repo
- 3
- Repo updated
- First seen
- Licence
- MIT
At a glance
Clean Architecture principles and best practices from Robert C.
- Works in 8 steps: Dependency Direction (CRITICAL) → Entity Design (CRITICAL) → Use Case Isolation (HIGH) → …
- Tasks involving layers
- SKILL.md covers When to Apply, Rule Categories by Priority, Quick Reference and How to Use, plus 1 more section
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Clean Architecture is an agent skill from GabrielMartinMoran/mind. Clean Architecture principles and best practices from Robert C. Martin's book. This skill should be used when designing software systems, reviewing code structure, or refactoring applications to achieve better separation of concerns. Triggers on tasks involving layers, boundaries, dependency direction, entities, use cases, or system architecture.
Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 47 other files, including reference files and assets (for example `assets/templates/_template.md`, `references/_sections.md` and `references/adapt-anti-corruption-layer.md`).
It sits in Development, covering Design patterns. The repository describes itself as: Mind is an automated memory layer for AI workflows. Say goodbye to your agents amnesia! The licence is MIT.
When your agent uses it
- Tasks involving layers
- Dependency direction
- System architecture
Example prompts
- “/clean-architecture”
Workflow steps
8 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 36d2f1e. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Clean Architecture loads about 1.9k tokens when it runs, and up to ~34k if it reads all its reference files. Until then it costs about 92 tokens; SKILL.md has 510 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from GabrielMartinMoran/mind at commit 36d2f1e, republished under its MIT licence (© GabrielMartinMoran). 510 words, ~1,850 tokens.
Download SKILL.mdSave it as
.claude/skills/clean-architecture/SKILL.md (or your agent's skills folder). This skill also uses 44 other files; get the full folder from GitHub.- name
- clean-architecture
- description
- Clean Architecture principles and best practices from Robert C. Martin's book. This skill should be used when designing software systems, reviewing code structure, or refactoring applications to achieve better separation of concerns. Triggers on tasks involving layers, boundaries, dependency direction, entities, use cases, or system architecture.
Clean Architecture Best Practices
Comprehensive guide to Clean Architecture principles for designing maintainable, testable software systems. Based on Robert C. Martin's "Clean Architecture: A Craftsman's Guide to Software Structure and Design." Contains 42 rules across 8 categories, prioritized by architectural impact.
When to Apply
Reference these guidelines when:
- Designing new software systems or modules
- Structuring dependencies between layers
- Defining boundaries between business logic and infrastructure
- Reviewing code for architectural violations
- Refactoring coupled systems toward cleaner structure
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Dependency Direction | CRITICAL | dep- |
| 2 | Entity Design | CRITICAL | entity- |
| 3 | Use Case Isolation | HIGH | usecase- |
| 4 | Component Cohesion | HIGH | comp- |
| 5 | Boundary Definition | MEDIUM-HIGH | bound- |
| 6 | Interface Adapters | MEDIUM | adapt- |
| 7 | Framework Isolation | MEDIUM | frame- |
| 8 | Testing Architecture | LOW-MEDIUM | test- |
Quick Reference
1. Dependency Direction (CRITICAL)
dep-inward-only- Source dependencies point inward onlydep-interface-ownership- Interfaces belong to clients not implementersdep-no-framework-imports- Avoid framework imports in inner layersdep-data-crossing-boundaries- Use simple data structures across boundariesdep-acyclic-dependencies- Eliminate cyclic dependencies between componentsdep-stable-abstractions- Depend on stable abstractions not volatile concretions
2. Entity Design (CRITICAL)
entity-pure-business-rules- Entities contain only enterprise business rulesentity-no-persistence-awareness- Entities must not know how they are persistedentity-encapsulate-invariants- Encapsulate business invariants within entitiesentity-value-objects- Use value objects for domain conceptsentity-rich-not-anemic- Build rich domain models not anemic data structures
3. Use Case Isolation (HIGH)
usecase-single-responsibility- Each use case has one reason to changeusecase-input-output-ports- Define input and output ports for use casesusecase-orchestrates-not-implements- Use cases orchestrate entities not implement business rulesusecase-no-presentation-logic- Use cases must not contain presentation logicusecase-explicit-dependencies- Declare all dependencies explicitly in constructorusecase-transaction-boundary- Use case defines the transaction boundary
4. Component Cohesion (HIGH)
comp-screaming-architecture- Structure should scream the domain not the frameworkcomp-common-closure- Group classes that change togethercomp-common-reuse- Avoid forcing clients to depend on unused codecomp-reuse-release-equivalence- Release components as cohesive unitscomp-stable-dependencies- Depend in the direction of stability
Show full SKILL.md (201 more words)Show less
5. Boundary Definition (MEDIUM-HIGH)
bound-humble-object- Use humble objects at architectural boundariesbound-partial-boundaries- Use partial boundaries when full separation is prematurebound-boundary-cost-awareness- Weigh boundary cost against ignorance costbound-main-component- Treat main as a plugin to the applicationbound-defer-decisions- Defer framework and database decisionsbound-service-internal-architecture- Services must have internal clean architecture
6. Interface Adapters (MEDIUM)
adapt-controller-thin- Keep controllers thinadapt-presenter-formats- Presenters format data for the viewadapt-gateway-abstraction- Gateways hide external system detailsadapt-mapper-translation- Use mappers to translate between layersadapt-anti-corruption-layer- Build anti-corruption layers for external systems
7. Framework Isolation (MEDIUM)
frame-domain-purity- Domain layer has zero framework dependenciesframe-orm-in-infrastructure- Keep ORM usage in infrastructure layerframe-web-in-infrastructure- Web framework concerns stay in interface layerframe-di-container-edge- Dependency injection containers live at the edgeframe-logging-abstraction- Abstract logging behind domain interfaces
8. Testing Architecture (LOW-MEDIUM)
test-tests-are-architecture- Tests are part of the system architecturetest-testable-design- Design for testability from the starttest-layer-isolation- Test each layer in isolationtest-boundary-verification- Verify architectural boundaries with tests
How to Use
Read individual reference files for detailed explanations and code examples:
- Section definitions - Category structure and impact levels
- Rule template - Template for adding new rules
Reference Files
| File | Description |
|---|---|
| references/_sections.md | Category definitions and ordering |
| assets/templates/_template.md | Template for new rules |
| metadata.json | Version and reference information |
© GabrielMartinMoran, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 44 other files (references, assets) in .agents/skills/clean-architecture of GabrielMartinMoran/mind.
- SKILL.md
- assets/templates/_template.md
- references/_sections.md
- references/adapt-anti-corruption-layer.md
- references/adapt-controller-thin.md
- references/adapt-gateway-abstraction.md
- references/adapt-mapper-translation.md
- references/adapt-presenter-formats.md
- references/bound-boundary-cost-awareness.md
- references/bound-defer-decisions.md
- references/bound-humble-object.md
- references/bound-main-component.md
- references/bound-partial-boundaries.md
- references/bound-service-internal-architecture.md
- references/comp-common-closure.md
- references/comp-common-reuse.md
- references/comp-reuse-release-equivalence.md
- references/comp-screaming-architecture.md
- … and 27 more
Open the folder on GitHubat commit 36d2f1e
Used in 1 other repository
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in GabrielMartinMoran/mind, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Clean Architecture next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Clean Architecture this skillGabrielMartinMoran/mind | 148 | 1 repos | ~1.9k | Automated safety check: Pass | MIT | |
| Vercel Composition Patternssupabase/supabase | 111k | 58 repos | ~726 | Automated safety check: Pass | MIT | |
| Swiftui View RefactorDimillian/Skills | 4k | 5 repos | ~2k | Automated safety check: Pass | MIT | |
| RTK Rust Design Patternsrtk-ai/rtk | 83k | — | ~1.9k | Automated safety check: Pass | Apache-2.0 | |
| Effect Client WrapperUsefulSoftwareCo/executor | 4.1k | 1 repos | ~1.4k | Automated safety check: Pass | MIT | |
| Architecture PatternsKartikLabhshetwar/better-shot | 2.4k | 2 repos | ~1.4k | Automated safety check: Pass | Custom licence |
Similar skills
- Official
Swiftui View Refactor
Dimillian/Skills
Refactor and review SwiftUI view files with strong defaults for small dedicated subviews, MV-over-MVVM data flow, stable view trees, explicit dependency injection, and correct Observation usage.
RTK Rust Design Patterns
rtk-ai/rtk
Describes seven Rust design patterns for the RTK CLI filter modules, with when to use each, RTK examples, and notes on when a pattern is overkill.
Effect Client Wrapper
UsefulSoftwareCo/executor
Pattern for wrapping third-party SDK clients (Stripe, Resend, AWS, etc.) with Effect.
Architecture Patterns
KartikLabhshetwar/better-shot
Deep dive into software architecture for macOS. An agent skill from KartikLabhshetwar/better-shot.
GitVersion .NET Development
GitTools/GitVersion
Gives repository-specific .NET guidance for GitVersion: build and test commands, central package management, project layout and coding conventions.
More from GabrielMartinMoran/mind
Bun Development
GabrielMartinMoran/mind
Modern JavaScript/TypeScript development with Bun runtime. An agent skill from GabrielMartinMoran/mind.
Clean Code
GabrielMartinMoran/mind
Applies principles from Robert C. An agent skill from GabrielMartinMoran/mind.
Related
Categories
Questions about Clean Architecture
What does Clean Architecture do?
Clean Architecture principles and best practices from Robert C. Clean Architecture is an agent skill from GabrielMartinMoran/mind. Clean Architecture principles and best practices from Robert C.
When should I use Clean Architecture?
Clean Architecture fits situations like: tasks involving layers; dependency direction; system architecture.
How do I install Clean Architecture in Claude Code?
Run `npx skills add GabrielMartinMoran/mind --skill clean-architecture -a claude-code`. Or copy the skill folder (.agents/skills/clean-architecture in GabrielMartinMoran/mind) into .claude/skills/clean-architecture in your project. Claude Code loads it when a task matches its description.
How do I install Clean Architecture in Codex?
Run `npx skills add GabrielMartinMoran/mind --skill clean-architecture -a codex`. Or copy the skill folder (.agents/skills/clean-architecture in GabrielMartinMoran/mind) into .agents/skills/clean-architecture in your project. Codex loads it when a task matches its description.
Can I use Clean Architecture in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add GabrielMartinMoran/mind --skill clean-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/clean-architecture, .gemini/skills/clean-architecture, .github/skills/clean-architecture and .opencode/skills/clean-architecture in your project.
What does Clean Architecture need to run?
SKILL.md names no scripts, command-line tools or credentials: Clean Architecture is instructions for the agent only.
Does Clean Architecture access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Clean Architecture safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Clean Architecture use?
Clean Architecture is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Clean Architecture use?
About 1.9k tokens (SKILL.md is roughly 7.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 32k tokens, read only when the agent opens those files.
What are the alternatives to Clean Architecture?
Skills that share tags, products or a category with Clean Architecture: Vercel Composition Patterns (supabase/supabase, 111k stars), Swiftui View Refactor (Dimillian/Skills, 4k stars), RTK Rust Design Patterns (rtk-ai/rtk, 83k stars) and Effect Client Wrapper (UsefulSoftwareCo/executor, 4.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Clean Architecture?
GabrielMartinMoran (a GitHub user) maintains it in GabrielMartinMoran/mind, which has 148 GitHub stars. The repository holds 3 skills in this directory. The repository was last updated on September 30, 2026.
Source: GabrielMartinMoran/mind on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.