architecture-diagrams

Generate Mermaid, PlantUML, and C4 architecture diagrams from Markdown.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/dereknex/skills --skill architecture-diagrams
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-diagrams
Source: https://github.com/dereknex/skills/tree/main/architecture-diagrams
Command: npx skills add https://github.com/dereknex/skills --skill architecture-diagrams

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Create clear, maintainable architecture diagrams using code-based diagramming tools like Mermaid and PlantUML for system design, data flows, and technical workflows.

Core Features & Use Cases

  • Mermaid, PlantUML, and C4 diagrams for system context, component relationships, deployment maps, and data-flow representations.
  • Use when documenting architectures, design reviews, or onboarding new engineers.

Quick Start

Generate a Mermaid system context diagram for an e-commerce platform showing client apps, API gateway, services, and data stores.

Frequently Asked Questions about architecture-diagrams

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

FAQPage Schema
How do I generate system context diagrams using code?

Generate system context diagrams by writing code-based blocks in Markdown using Mermaid or PlantUML. This approach visualizes system design, component relationships, and data flows directly within your documentation files.

Can I use Mermaid and PlantUML for C4 model deployment maps?

Yes, Mermaid and PlantUML support C4 model diagrams for deployment maps and component relationships. They render system contexts and data flows directly from code blocks embedded in Markdown documentation.

What is the best way to document software architecture as code?

Document software architecture as code by embedding Mermaid or PlantUML diagram blocks within Markdown files. This method ensures maintainable, version-controlled visualizations for design reviews and engineering onboarding.

Do I need a specific format to create data flow diagrams in Markdown?

You need a Markdown file with YAML frontmatter containing name and description fields, plus diagram code blocks. This structure renders data flow and architecture diagrams properly for technical documentation tasks.

When should I use code-based diagrams over visual tools for system design?

Use code-based diagrams for system design when you need maintainable, version-controlled architecture visualizations. This approach suits documentation tasks, design reviews, and onboarding new engineers better than static visual tools.