Skip to content
TakoAPI
Back to skills

skill-mermaid-diagrams

by chunhualiao

Coding Agents & IDEs
481Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Generate consistent, template-based Mermaid diagrams for technical content.

Description

What This Skill Does

Generates Mermaid diagrams from 12 pre-built templates with LLM-powered placeholder filling. Supports architecture, flowchart, sequence, Gantt, class, and state diagram types with a consistent color scheme. A subagent handles the full workflow: reading source content, selecting templates, rendering diagrams, and validating output.

Rendering diagrams locally with mermaid-cli costs 95-99% less than AI image generation services while producing consistently styled, version-controllable vector output.

When to Use It

  • Generating system architecture diagrams for technical documentation
  • Creating Gantt charts for project milestone tracking
  • Producing UML class diagrams from code structure descriptions
  • Building sequence diagrams for API interaction walkthroughs
  • Visualizing process state machines in workflow documentation

Example Workflow

INPUT

User asks: Generate 3 diagrams for chapters/chapter-05.md

AGENT
  1. 1

    Reads chapter-05.md and analyzes its content

  2. 2

    Selects 3 appropriate templates from the 12 available types

  3. 3

    Fills each template's placeholders with labels derived from chapter content and writes content.json

  4. 4

    Runs generate.mjs to render .mmd source, .svg, and .png files

  5. 5

    Runs validate.mjs to confirm all outputs rendered without errors or unresolved placeholders

OUTPUT

3 diagram sets saved to diagrams/chapter-05/ as .mmd, .svg, and .png files with a summary.json metadata file

Requirements

  • mermaid-cli >= 11.0.0 installed globally via npm install -g @mermaid-js/mermaid-cli

Installation

clawhub install chunhualiao/skill-mermaid-diagrams

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links