Skip to main content
NeVibeCode · collection · 30 · list updated

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. 1

    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

    128,500installs
  2. 2

    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

    101,800installs
  3. 3

    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

    81,900installs
  4. 4

    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

    80,700installs
  5. 5

    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

    47,000installs
  6. 6

    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

    44,600installs
  7. 7

    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

    43,800installs
  8. 8

    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

    42,900installs
  9. 9

    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

    32,000installs
  10. 10

    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

    30,900installs
  11. 11

    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

    26,900installs
  12. 12

    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

    25,700installs
  13. 13

    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

    25,600installs
  14. 14

    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

    22,036installs
  15. 15

    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

    18,400installs
  16. 16

    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,800installs
  17. 17

    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

    16,200installs
  18. 18

    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

    15,400installs
  19. 19

    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

    15,100installs
  20. 20

    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

    12,558installs
  21. 21

    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

    12,196installs
  22. 22

    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

    11,300installs
  23. 23

    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

    11,000installs
  24. 24

    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

    10,600installs
  25. 25

    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

    10,100installs
  26. 26

    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

    8,900installs
  27. 27

    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

    8,800installs
  28. 28

    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

    8,500installs
  29. 29

    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

    7,900installs
  30. 30

    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

    7,800installs

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

Project sponsors

Companies that keep this analytics open