Home
cd ../playbooks
Creative & DesignAdvanced

Diagram & Flowchart Creator

Create professional diagrams using Mermaid, PlantUML, and other text-based diagram tools. Generate flowcharts, sequence diagrams, architecture diagrams, and more.

10 minutes
By communitySource
#diagram#flowchart#mermaid#plantuml#architecture

You spent 45 minutes dragging boxes in Lucidchart and it still looks crooked. Every time the architecture changes, you redraw the whole thing. Text-based diagrams update in seconds and live next to your code.

Who it's for: developers documenting system architecture, tech leads creating design docs, engineering teams needing version-controlled diagrams, technical writers illustrating workflows, anyone tired of drag-and-drop diagram tools

Example

"Create an architecture diagram for our microservices setup" → Mermaid diagram showing service dependencies, data flows, and API boundaries — rendered inline in your docs, version-controlled in git, and updated by editing text

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

Or install from your terminal:
npx ccplaybooks add diagram-creator
# Diagram Creator

## Overview

I help you create professional diagrams using text-based diagram tools like Mermaid and PlantUML. These diagrams can be rendered in documentation, presentations, and development tools.

**What I can do:**
- Create flowcharts and process diagrams
- Generate sequence diagrams
- Build architecture and system diagrams
- Design ER (Entity-Relationship) diagrams
- Create class diagrams and UML

Get new playbooks like this one

One email a week with new Claude Code workflows. Free, like everything here.

No spam. Unsubscribe anytime.

README.md

What This Does

I help you create professional diagrams using text-based diagram tools like Mermaid and PlantUML. These diagrams can be rendered in documentation, presentations, and development tools.


Quick Start

Step 1: Create a Project Folder

mkdir -p ~/Documents/DiagramCreator

Step 2: Download the Template

Click Download above, then:

mv ~/Downloads/CLAUDE.md ~/Documents/DiagramCreator/

Step 3: Start Working

cd ~/Documents/DiagramCreator
claude

How to Use

Step 1: Describe Your Diagram

Tell me:

  • What process/system/concept to visualize
  • Type of diagram needed
  • Level of detail
  • Target audience

Step 2: Choose Format

  • Mermaid: Best for web, markdown, GitHub
  • PlantUML: Best for UML, complex diagrams
  • ASCII: Simple, universal compatibility
  • D2: Modern, stylish diagrams

Step 3: Specify Style

  • Colors and themes
  • Direction (top-down, left-right)
  • Level of detail

Output Format

# Diagram: [Name]

**Type**: [Flowchart / Sequence / Architecture / etc.]
**Tool**: [Mermaid / PlantUML]
**Purpose**: [What it illustrates]

---

Tips

  1. Keep it simple - Don't overcrowd
  2. Use consistent naming - Clear, descriptive labels
  3. Group related items - Use subgraphs/packages
  4. Choose appropriate type - Match diagram to concept
  5. Consider audience - Technical vs. business
  6. Use colors sparingly - For emphasis only
  7. Add legends - When using symbols/colors
  8. Maintain hierarchy - Top-down or left-right flow

Limitations

  • Cannot render images directly
  • Complex layouts may need manual adjustment
  • Limited styling compared to design tools
  • Some diagram types not supported in all tools

$Related Playbooks

Creative & Design

Excalidraw Diagram Generator

Generate Excalidraw diagrams directly from text in three formats — Obsidian-ready .md, standalone .excalidraw for excalidraw.com, and an animated .excalidraw with per-element playback order — with the exact JSON element schema (including the undocumented fields that break excalidraw.com if included), a font-size floor, and a full color palette with contrast rules.

5 minutes
Intermediate
Creative & Design

HTML to PowerPoint Converter

Convert HTML/Markdown to PowerPoint presentations using Marp

10 minutes
Advanced
Creative & Design

AI Image Generation Prompts

Create effective AI image generation prompts for DALL-E, Midjourney, and Stable Diffusion. Generate prompts for various styles and use cases.

10 minutes
Intermediate
Creative & Design

Infographic Layout Designer

Design infographic layouts and content structure. Plan visual storytelling with data, icons, and text hierarchy for impactful information design.

10 minutes
Intermediate
Creative & Design

AI Image Enhancer — Upscale & Sharpen Photos with Claude Code

Upscale low-resolution images, sharpen blurry photos, and remove compression artifacts using Claude Code. Batch-process screenshots, product photos, and graphics for professional quality.

5 minutes
Beginner
Creative & Design

Markdown to Slides Converter

Convert Markdown files into professional presentations exportable to PDF, PPTX, or HTML using Marp.

10 minutes
Beginner
Creative & Design

Structured Design Critique System

A persistent, multi-round design critique pipeline: scope which of 19 design areas your project actually needs, generate real HTML wireframe options for each, collect Keep/Cut feedback, and let locked decisions constrain everything downstream.

15 minutes
Advanced
Creative & Design

Narrative Slide Creator

Narrative-first slide deck creation — design a structured narrative (the ABCDEFG model) first, then generate the visuals, so the story drives the design rather than the other way around.

15 minutes
Intermediate
Creative & Design

Scientific Markdown Mermaid Writing

Comprehensive markdown and Mermaid diagram writing skill. Use when creating any scientific document, report, analysis, or visualization. Establishes text-based diagrams as the default documentation standard with full style guides (markdown + merma...

5 minutes
Beginner
Creative & Design

Scientific Markitdown

Convert files and office documents to Markdown. Supports PDF, DOCX, PPTX, XLSX, images (with OCR), audio (with transcription), HTML, CSV, JSON, XML, ZIP, YouTube URLs, EPubs and more.

5 minutes
Beginner
Creative & Design

Scientific Paper 2 Web

This skill should be used when converting academic papers into promotional and presentation formats including interactive websites (Paper2Web), presentation videos (Paper2Video), and conference posters (Paper2Poster). Use this skill for tasks invo...

10 minutes
Intermediate
Creative & Design

Scientific Pdf

Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDF...

5 minutes
Beginner

Browse all Creative & Design playbooks →