diagram

Create and maintain Mermaid diagrams in markdown documentation.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/supermalang/ai-augmented-coding --skill diagram-supermalang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagram
Source: https://github.com/supermalang/ai-augmented-coding/tree/main/.claude/skills/diagram
Command: npx skills add https://github.com/supermalang/ai-augmented-coding --skill diagram-supermalang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of explaining systems, flows, and data relationships in prose alone by turning them into clear, version-controlled Mermaid diagrams that are easy to review and keep current.

Core Features & Use Cases

It creates and updates diagrams for architecture, sequence flows, ERDs, user journeys, and pipelines directly in markdown documentation. It is useful when a codebase needs a visual explanation of how components interact, how data is modeled, or how a process moves from step to step. It keeps diagrams close to the docs they support so teams can understand changes faster and spot inconsistencies before they spread.

Quick Start

Use the diagram skill to inspect the relevant source of truth and write the appropriate Mermaid diagram into the most relevant markdown document.

Frequently Asked Questions about diagram

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

FAQPage Schema
How do I create Mermaid diagrams for markdown documentation?

Creating Mermaid diagrams for markdown documentation involves inspecting the relevant source of truth and writing the appropriate diagram syntax directly into the markdown file. This applies to architecture, sequence, ERD, workflow, and pipeline diagrams.

Can I generate architecture and ERD diagrams directly in markdown docs?

Yes, you can generate architecture and ERD diagrams directly in markdown docs. The process derives accurate visual representations from your source of truth and embeds them without modifying underlying code or database schemas.

What is the best way to maintain version-controlled diagrams for software architecture?

The best way to maintain version-controlled diagrams for software architecture is using Mermaid syntax embedded in markdown. This keeps diagrams close to the docs so teams can review changes faster and spot inconsistencies before they spread.

Do GitHub markdown files render Mermaid workflow diagrams automatically?

Yes, GitHub markdown files render Mermaid workflow diagrams automatically. The diagramming process requires GitHub-compatible rendering and valid Mermaid syntax to ensure workflows display correctly in documentation repositories.

Will generating sequence diagrams modify my codebase or database schema?

No, generating sequence diagrams will not modify your codebase or database schema. The process performs documentation-only updates, strictly deriving accurate source-of-truth diagrams without altering code or schema.