system-designer

Generate C4 system context and container diagrams in Mermaid syntax from BRIEF.md, DOMAIN-MODEL.md, and ADR files.

Updated Feb 21, 2026
One-click install
npx skills add https://github.com/buddypia/kaiju-voice --skill system-designer-buddypia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-designer
Source: https://github.com/buddypia/kaiju-voice/tree/main/.claude/skills/system-designer
Command: npx skills add https://github.com/buddypia/kaiju-voice --skill system-designer-buddypia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the generation of system architecture diagrams based on the C4 model (Level 1 and Level 2), transforming textual requirements into visual blueprints for better understanding and communication.

Core Features & Use Cases

  • C4 Model Diagram Generation: Creates System Context (Level 1) and Container (Level 2) diagrams using Mermaid syntax.
  • Automated Documentation: Outputs a SYSTEM-DESIGN.md file containing diagrams and descriptions.
  • Use Case: When a new feature is defined, this Skill can automatically generate the initial architectural diagrams, ensuring consistency and saving significant design time.

Quick Start

Use the system-designer skill to generate system design diagrams for feature ID '029-vocabulary-book'.

Frequently Asked Questions about system-designer

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

FAQPage Schema
How do I generate C4 model architecture diagrams automatically?

To generate C4 model architecture diagrams automatically, this Skill analyzes BRIEF.md, DOMAIN-MODEL.md, and ADR files to produce Mermaid syntax diagrams for Level 1 System Context and Level 2 Container views in a SYSTEM-DESIGN.md document.

What is the best way to create a System Context diagram from markdown requirements?

Creating a System Context diagram from markdown requirements involves parsing textual documents like BRIEF.md and ADR files to map system boundaries and data flows, which this Skill automates using Mermaid syntax.

How do I document system containers and data flows in Mermaid?

To document system containers and data flows in Mermaid, the Skill extracts architectural components from your domain model and ADRs, generating Level 2 Container diagrams that visually represent the internal structure and interactions.

Do I need ADR files to generate a SYSTEM-DESIGN.md document?

Yes, ADR files are required alongside BRIEF.md and DOMAIN-MODEL.md to generate the SYSTEM-DESIGN.md document, as the Skill relies on these inputs to accurately map system boundaries, containers, and data flows for the C4 diagrams.

Can I use this to generate Level 3 Component diagrams for my software architecture?

No, you cannot use this to generate Level 3 Component diagrams. The Skill specifically automates C4 model diagram generation for Level 1 System Context and Level 2 Container views using Mermaid syntax.

Why use the C4 model over other architecture diagram formats?

Using the C4 model over other architecture diagram formats provides structured hierarchical visualization—System Context and Container levels—that transforms textual requirements into clear visual blueprints, improving communication and architectural consistency.