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.
Ordered by install count from the source, then by repository stars on GitHub. A language model writes each description from the source file; only descriptions that passed the automatic check are listed.
-
1
128,500installs
lean-build
lean-build prevents overbuilding when adding new features or integrations. It sets strict acceptance bounds, cuts speculative abstractions, and stops immediately once proof passes.
skill · JuliusBrussee · Apache-2.0
-
2
101,800installs
design-doc-mermaid
design-doc-mermaid generates Mermaid diagrams and design documents from code or user prompts. Useful for GitHub wiki pages, architecture reviews, and sequence flows.
skill · SpillwaveSolutions
-
3
81,900installs
spec-driven-development
The spec-driven-development Claude Code skill drafts a specification before coding begins. It activates for vague requirements, new features, project plans, and changes to an existing spec.
skill · addyosmani · MIT
-
4
80,700installs
documentation-and-adrs
The documentation-and-adrs Claude Code skill records architecture decisions and helps detect documentation that no longer matches the code. It applies during public API changes, feature releases, and documentation checks.
skill · addyosmani · MIT
-
5
47,000installs
flutter-apply-architecture-best-practices
The flutter-apply-architecture-best-practices skill structures Flutter apps around UI, Logic, and Data layers. Use it when starting a project or refactoring code for scale.
skill · flutter · BSD-3-Clause
-
6
44,600installs
golang-design-patterns
The golang-design-patterns skill guides idiomatic Go design for APIs, resource lifecycles, graceful shutdown, and architecture. Use it when designing or reviewing Go code.
skill · samber · MIT
-
7
43,800installs
convex-explain-app
convex-explain-app maps an existing Convex backend using schema and exported functions. It helps you understand data models, public APIs, and auth before making changes.
skill · convex · Apache-2.0
-
8
42,900installs
golang-project-layout
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.
skill · samber · MIT
-
9
32,000installs
nestjs-best-practices
nestjs-best-practices is a Claude Code skill for writing, reviewing, and refactoring NestJS code. It covers architecture, security, and performance tasks.
skill · Kadajett · MIT
-
10
30,900installs
diagram-design
diagram-design is a Claude Code skill that builds editorial diagrams as standalone HTML files with inline SVG. It covers 51 visual types under a project-specific style guide.
skill · cathrynlavery · MIT
-
11
26,900installs
writing-design-docs
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.
skill · riekelt · MIT
-
12
25,700installs
principal-engineering
principal-engineering enforces core engineering discipline for AI agents: mandates pre-change checkpoints, bans silent error suppression, and requires evidence from real code.
skill · riekelt
-
13
25,600installs
guarding-architecture
guarding-architecture enforces system boundaries by turning structural invariants into breaking build tests. Useful when code crosses module limits or adds unwanted cross-package imports.
skill · riekelt
-
14
22,036installs
architecture-decision-records
Writes and maintains Architecture Decision Records (ADRs) — documents capturing technical decisions. Runs when you need to record a database choice, framework adoption or integration pattern.
skill · Seth Hobson · MIT
-
15
18,400installs
fireworks-tech-graph
fireworks-tech-graph builds precise technical SVG diagrams, exports them to PNG or standalone HTML, and animates semantic SVGs into GIFs. Suitable for system architecture, UML, and cloud workflows.
skill · yizhiyanhua-ai · MIT
-
16
17,800installs
bmad-architecture
bmad-architecture writes a short architecture document that pins down only the invariants keeping independently built parts of a system from diverging.
skill · bmad-code-org · MIT
-
17
16,200installs
baoyu-diagram
baoyu-diagram builds system and workflow diagrams as self-contained SVGs with dark and light themes, exporting both versions to @2x PNGs.
skill · JimLiu · MIT
-
18
15,400installs
think
think is a Claude Code skill that turns an idea into a concrete plan before coding starts. It activates for architecture decisions, build-or-drop judgments, and task handoffs.
skill · tw93 · MIT
-
19
15,100installs
plannotator-visual-explainer
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.
skill · backnotprop · Apache-2.0
-
20
12,558installs
create-implementation-plan official
The create-implementation-plan skill creates a Markdown implementation plan for features, refactoring, package upgrades, or infrastructure work. Use it when an agent needs an explicit task breakdown.
skill · github · MIT
-
21
12,196installs
architecture-blueprint-generator official
architecture-blueprint-generator analyzes a codebase and creates an architecture blueprint with components, dependencies, and diagrams. Use it before extending a project or onboarding developers.
skill · github · MIT
-
22
11,300installs
unity-scriptableobjects
The unity-scriptableobjects Claude Code skill sets up ScriptableObject architecture in Unity 6.3 LTS. It handles configuration assets, shared runtime variables, and decoupled event channels.
skill · gamedev-skills · Apache-2.0
-
23
11,000installs
cqrs-implementation
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.
skill · Seth Hobson · MIT
-
24
10,600installs
architect
architect is a Claude Code skill that sketches types, signatures, and module boundaries before coding. It triggers on /architect or when a complex change needs architectural design.
skill · backnotprop · MIT
-
25
10,100installs
principle-separate-before-serializing-shared-state
principle-separate-before-serializing-shared-state is a Claude Code skill for concurrent writes. It guides agents to separate files or keys per actor instead of serializing a shared state file.
skill · backnotprop · MIT
-
26
8,900installs
excalidraw-diagram
excalidraw-diagram generates .excalidraw JSON diagram files for technical architectures and workflows. Helps turn system specs or logic into diagrams with real data examples.
skill · coleam00
-
27
8,800installs
drawio
Builds and edits draw.io diagrams through offline YAML specifications. Useful for architecture maps and network topologies without manual drag-and-drop.
skill · bahayonghang · MIT
-
28
8,500installs
architecture-designer
architecture-designer designs distributed system architectures, creates Mermaid diagrams, and writes Architecture Decision Records. It helps balance trade-offs before writing service code.
skill · https://github.com/Jeffallan · MIT
-
29
7,900installs
system-design official
system-design walks you through designing services and systems: requirements, components, trade-offs. Useful when you need to decide how to split a service into parts.
skill · anthropics · Apache-2.0
-
30
7,800installs
adhd
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.
skill · UditAkhourii · MIT
How to choose an architecture skill
The catalog has 467 architecture skills. It helps to sort them by when they act. Before code: a spec, the design of types and module boundaries, a decision document. During: skills that keep the agent from extra layers and complexity. After: rules turned into automated tests on architecture boundaries. A separate group draws diagrams in Mermaid, draw.io and Excalidraw.
Skills for a specific stack (Go project layout, Flutter layers, NestJS) are more precise than generic ones. Nearby: planning and spec skills, code review and refactoring, backend.
FAQ
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.
Other collections
- Best Claude Code skills
- Best Claude Code plugins
- Best Claude Code subagents
- Best Codex skills
- Best Cursor rules
- Best MCP servers
- MCP servers for Cursor
- Frontend skills
- Testing skills
- Security skills and rules
- SEO and marketing skills
- Design skills
- DevOps skills
- MCP servers for databases
- Browser and scraping MCP servers
- Code review and refactoring skills
- Skills and MCP for game development and 3D
- Video generation and editing skills
- Mobile development skills
- Backend and API skills
- Marketing skills and agents
- Scientific skills for AI agents
- UI/UX design skills
- Writing skills
- Claude Code hooks examples
- Claude Code slash commands
- Best Codex plugins
- GitHub Copilot agent skills
- Gemini CLI extensions and skills
- GitHub Copilot instructions
- MCP servers for Claude Code
- MCP servers for Codex
- MCP servers for VS Code
- Remote MCP servers
- Security MCP servers
- Office skills: slides, PDF, Word, Excel
- Data analysis skills
- Research skills
- Telegram AI agent tools
- 1C AI agent tools
- Codex subagents
- Cursor skills
- OpenCode skills
- Animation skills
- Presentation skills
- PDF skills
- Planning and spec skills
- Debugging skills
- Audio, voice and music skills
- Branding and logo skills
- Humanizer and AI-text detector skills
- Game design skills
- Product management skills
- SwiftUI and iOS design skills
- HyperFrames skills
- Figma skills
- Blender skills
- Unity skills
- Godot skills