system-design

Generate Mermaid diagrams for system design and architecture visualization.

2|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/atilladeniz/next-go-pg --skill system-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-design
Source: https://github.com/atilladeniz/next-go-pg/tree/main/.claude/skills/system-design
Command: npx skills add https://github.com/atilladeniz/next-go-pg --skill system-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies the process of documenting and communicating complex system architectures, data flows, and business logic. By leveraging Mermaid diagrams, it allows you to quickly create clear, text-based visualizations, reducing ambiguity and improving collaboration among team members.

Core Features & Use Cases

  • Mermaid Diagram Generation: Supports various diagram types including Flowchart, Sequence, ER, State, and C4 Context.
  • Structured Documentation: Guides on organizing diagrams within .concepts/ for architecture, flows, and data models.
  • Business Logic Visualization: Helps translate complex business requirements into easy-to-understand visual representations.
  • Use Case: When explaining a new feature's backend interactions, use this skill to generate a Mermaid sequence diagram that clearly illustrates the API calls and service interactions between different microservices or components.

Quick Start

Generate a simple Mermaid flowchart to visualize a decision-making process, for example, "User logs in" -> "Is user authenticated?" -> "Yes: Go to Dashboard" / "No: Show Login Error".

Frequently Asked Questions about system-design

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create system architecture diagrams with Mermaid?

Mermaid diagrams visualize system architecture by converting text-based syntax into flowcharts, sequence diagrams, C4 models, and ER diagrams. Write diagram code specifying components, relationships, and flows, then render them as clear visual representations of your system design without requiring external drawing tools.

What diagram types can I generate to document data models and flows?

Mermaid supports C4Context, C4Container, Flowchart, Sequence, ER Diagram, Class Diagram, State Diagram, and Mind Map formats. Each type serves different documentation needs: ER diagrams model database schemas, sequence diagrams show service interactions, flowcharts illustrate decision logic, and C4 diagrams decompose system architecture at multiple abstraction levels.

Can I use Mermaid diagrams to explain microservice interactions?

Yes. Sequence diagrams in Mermaid document API calls and interactions between microservices and components. Generate syntactically correct diagrams that map business requirements into visual flows showing request paths, response handling, and service dependencies across your distributed system.

How should I organize and store architecture diagrams in my project?

Save Mermaid diagrams under the `.concepts/` directory in category-specific subfolders—organize by architecture, flows, and data models. This structure keeps documentation discoverable, maintainable, and aligned with your codebase while making business logic and system design reasoning explicit alongside visual representations.

What's the best way to document complex business logic visually?

Translate business requirements into Mermaid flowcharts or state diagrams, documenting the logic before generating diagram code. This approach reduces ambiguity, clarifies decision points and edge cases, and creates shared reference material that improves team collaboration during architecture reviews and feature planning.