# Software architecture skills

Software architecture skills are instructions Claude Code or Codex follow to design module boundaries before writing code, keep architecture decision records (ADRs), draw diagrams and make sure new changes do not break the agreed structure. These are the top 30 by installs. They go in .claude/skills for Claude Code and .agents/skills for Codex.

Top 30 of 467 by installs (by repository stars when installs are unknown).

- HTML: https://affpapa.org/en/nevibecode/best/architecture-skills
- Instructions for agents: https://affpapa.org/en/nevibecode/agents.md

- [lean-build](https://affpapa.org/en/nevibecode/skills/lean-build.md) — skill · JuliusBrussee · Claude Code, Codex, Cursor +5 · 128500 installs — lean-build prevents overbuilding when adding new features or integrations.
- [design-doc-mermaid](https://affpapa.org/en/nevibecode/skills/design-doc-mermaid.md) — skill · SpillwaveSolutions · Claude Code, Codex, Cursor +5 · 101800 installs — design-doc-mermaid generates Mermaid diagrams and design documents from code or user prompts.
- [spec-driven-development](https://affpapa.org/en/nevibecode/skills/spec-driven-development.md) — skill · addyosmani · Claude Code, Codex, Cursor +5 · 81900 installs — The spec-driven-development Claude Code skill drafts a specification before coding begins.
- [documentation-and-adrs](https://affpapa.org/en/nevibecode/skills/documentation-and-adrs.md) — skill · addyosmani · Claude Code, Codex, Cursor +5 · 80700 installs — The documentation-and-adrs Claude Code skill records architecture decisions and helps detect documentation that no longer matches the code.
- [flutter-apply-architecture-best-practices](https://affpapa.org/en/nevibecode/skills/flutter-apply-architecture-best-practices.md) — skill · flutter · Claude Code, Codex, Cursor +5 · 47000 installs — The flutter-apply-architecture-best-practices skill structures Flutter apps around UI, Logic, and Data layers.
- [golang-design-patterns](https://affpapa.org/en/nevibecode/skills/golang-design-patterns.md) — skill · samber · Claude Code, Codex, Cursor +5 · 44600 installs — The golang-design-patterns skill guides idiomatic Go design for APIs, resource lifecycles, graceful shutdown, and architecture.
- [convex-explain-app](https://affpapa.org/en/nevibecode/skills/convex-explain-app.md) — skill · convex · Claude Code, Codex, Cursor +5 · 43800 installs — convex-explain-app maps an existing Convex backend using schema and exported functions.
- [golang-project-layout](https://affpapa.org/en/nevibecode/skills/golang-project-layout.md) — skill · samber · Claude Code, Codex, Cursor +5 · 42900 installs — golang-project-layout is a Claude Code skill that organizes Go projects by convention, asking about architecture and dependency injection before scaffolding files and config.
- [nestjs-best-practices](https://affpapa.org/en/nevibecode/skills/nestjs-best-practices.md) — skill · Kadajett · Claude Code, Codex, Cursor +5 · 32000 installs — nestjs-best-practices is a Claude Code skill for writing, reviewing, and refactoring NestJS code.
- [diagram-design](https://affpapa.org/en/nevibecode/skills/diagram-design.md) — skill · cathrynlavery · Claude Code, Codex, Cursor +5 · 30900 installs — diagram-design is a Claude Code skill that builds editorial diagrams as standalone HTML files with inline SVG.
- [writing-design-docs](https://affpapa.org/en/nevibecode/skills/writing-design-docs.md) — skill · riekelt · Claude Code, Codex, Cursor +5 · 26900 installs — writing-design-docs is a Claude Code skill that structures RFCs and architecture proposals with conclusions, goals and non-goals, Why & What boxes, and vagueness checks.
- [principal-engineering](https://affpapa.org/en/nevibecode/skills/principal-engineering.md) — skill · riekelt · Claude Code, Codex, Cursor +5 · 25700 installs — principal-engineering enforces core engineering discipline for AI agents: mandates pre-change checkpoints, bans silent error suppression, and requires evidence from real code.
- [guarding-architecture](https://affpapa.org/en/nevibecode/skills/guarding-architecture.md) — skill · riekelt · Claude Code, Codex, Cursor +5 · 25600 installs — guarding-architecture enforces system boundaries by turning structural invariants into breaking build tests.
- [architecture-decision-records](https://affpapa.org/en/nevibecode/skills/architecture-decision-records.md) — skill · Seth Hobson · Claude Code, Codex, Cursor +4 · 22036 installs — A skill for Claude Code, Codex and Cursor that writes and maintains Architecture Decision Records (ADRs) — documents capturing technical decisions.
- [fireworks-tech-graph](https://affpapa.org/en/nevibecode/skills/fireworks-tech-graph.md) — skill · yizhiyanhua-ai · Claude Code, Codex, Cursor +5 · 18400 installs — fireworks-tech-graph builds precise technical SVG diagrams, exports them to PNG or standalone HTML, and animates semantic SVGs into GIFs.
- [bmad-architecture](https://affpapa.org/en/nevibecode/skills/bmad-architecture.md) — skill · bmad-code-org · Claude Code, Codex, Cursor +5 · 17800 installs — bmad-architecture writes a short architecture document that pins down only the invariants keeping independently built parts of a system from diverging.
- [baoyu-diagram](https://affpapa.org/en/nevibecode/skills/baoyu-diagram.md) — skill · JimLiu · Claude Code, Codex, Cursor +5 · 16200 installs — baoyu-diagram builds system and workflow diagrams as self-contained SVGs with dark and light themes, exporting both versions to @2x PNGs.
- [think](https://affpapa.org/en/nevibecode/skills/think.md) — skill · tw93 · Claude Code, Codex, Cursor +5 · 15400 installs — think is a Claude Code skill that turns an idea into a concrete plan before coding starts.
- [plannotator-visual-explainer](https://affpapa.org/en/nevibecode/skills/plannotator-visual-explainer.md) — skill · backnotprop · Claude Code, Codex, Cursor +5 · 15100 installs — plannotator-visual-explainer is a Claude Code skill that creates HTML visualizations of plans, PR explainers, architecture diagrams, and slide decks in Plannotator's dark theme.
- [create-implementation-plan](https://affpapa.org/en/nevibecode/skills/create-implementation-plan.md) — skill (official GitHub) · github · GitHub Copilot, Claude Code, Codex +4 · 12558 installs — The create-implementation-plan skill creates a Markdown implementation plan for features, refactoring, package upgrades, or infrastructure work.
- [architecture-blueprint-generator](https://affpapa.org/en/nevibecode/skills/architecture-blueprint-generator.md) — skill (official GitHub) · github · GitHub Copilot, Claude Code, Codex +4 · 12196 installs — architecture-blueprint-generator analyzes a codebase and creates an architecture blueprint with components, dependencies, and diagrams.
- [unity-scriptableobjects](https://affpapa.org/en/nevibecode/skills/unity-scriptableobjects.md) — skill · gamedev-skills · Claude Code, Codex, Cursor +5 · 11300 installs — The unity-scriptableobjects Claude Code skill sets up ScriptableObject architecture in Unity 6.3 LTS.
- [cqrs-implementation](https://affpapa.org/en/nevibecode/skills/cqrs-implementation.md) — skill · Seth Hobson · Claude Code, Codex, Cursor +4 · 11000 installs — cqrs-implementation — a skill for Claude Code, Codex, and Cursor that implements CQRS: splits read and write models, wires up command handlers, and builds projectors.
- [architect](https://affpapa.org/en/nevibecode/skills/backnotprop-architect.md) — skill · backnotprop · Claude Code, Codex, Cursor +5 · 10600 installs — architect is a Claude Code skill that sketches types, signatures, and module boundaries before coding.
- [principle-separate-before-serializing-shared-state](https://affpapa.org/en/nevibecode/skills/principle-separate-before-serializing-shared-state.md) — skill · backnotprop · Claude Code, Codex, Cursor +5 · 10100 installs — principle-separate-before-serializing-shared-state is a Claude Code skill for concurrent writes.
- [excalidraw-diagram](https://affpapa.org/en/nevibecode/skills/excalidraw-diagram.md) — skill · coleam00 · Claude Code, Codex, Cursor +5 · 8900 installs — excalidraw-diagram generates .excalidraw JSON diagram files for technical architectures and workflows.
- [drawio](https://affpapa.org/en/nevibecode/skills/bahayonghang-drawio.md) — skill · bahayonghang · Claude Code, Codex, Cursor +5 · 8800 installs — Builds and edits draw.io diagrams through offline YAML specifications.
- [architecture-designer](https://affpapa.org/en/nevibecode/skills/architecture-designer.md) — skill · https://github.com/Jeffallan · Claude Code, Codex, Cursor +5 · 8500 installs — architecture-designer designs distributed system architectures, creates Mermaid diagrams, and writes Architecture Decision Records.
- [system-design](https://affpapa.org/en/nevibecode/skills/system-design.md) — skill (official Anthropic) · anthropics · Claude Code, Codex, Cursor +5 · 7900 installs — system-design walks you through designing services and systems: requirements, components, trade-offs.
- [adhd](https://affpapa.org/en/nevibecode/skills/adhd.md) — skill · UditAkhourii · Claude Code, Codex, Cursor +5 · 7800 installs — adhd — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that spawns parallel agents under different cognitive frames and surfaces the best ideas past the obvious three.

## Questions

**Is there a clean architecture skill for Codex or Claude Code?**
Yes. The catalog has 467 architecture skills: decision records (ADRs), CQRS, layered project layout, system design. By installs, the list is led by lean-build, design-doc-mermaid and spec-driven-development.

**Why is an architecture skill better than a plain prompt?**
It fires on its own when a task matches its description and sets the same order every time: boundaries and decisions first, code second. A prompt has to be repeated in every session.

**How do I keep the agent from breaking the project architecture?**
Install a skill that turns architecture rules into automated tests: the list has one. Keep decision records (ADRs) in the repository so the agent reads them in later sessions.

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
