diagrams

Create diagrams and visualizations in Markdown using Mermaid, Graphviz, Vega-Lite, PlantUML, and HTML templates.

Updated May 30, 2026
One-click install
npx skills add https://github.com/chloebrett/snitchos --skill diagrams-chloebrett
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: diagrams
Source: https://github.com/chloebrett/snitchos/tree/main/.claude/skills/diagrams
Command: npx skills add https://github.com/chloebrett/snitchos --skill diagrams-chloebrett

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Choosing the right diagram syntax and writing correct rendering code for flowcharts, charts, architecture diagrams, and infographics in Markdown is error-prone and time-consuming. This Skill provides a decision guide plus detailed syntax references so every diagram renders correctly on the first attempt. ## Core Features & Use Cases - Multi-tool diagram generation: Supports Mermaid (flowcharts, sequence, ER, state), Graphviz (dependency graphs), Vega-Lite (data charts), PlantUML (UML, cloud architecture with 9,500+ stencils), infographics (KPI cards, roadmaps, funnels, SWOT), JSON Canvas (mind maps), and raw-HTML architecture diagrams and infocards. - Decision guide: A selection table maps each visualization need to the correct tool and code fence, with quick selection rules for common scenarios. - Syntax rule enforcement: Each reference file documents critical pitfalls (e.g., Mermaid list syntax conflicts, PlantUML @startuml/@enduml requirements, Vega-Lite schema requirements) to prevent rendering failures. - Use Case: When documenting a microservices platform, generate a PlantUML component diagram with AWS stencil icons, a Vega-Lite latency chart, and an infographic KPI dashboard, all embedded in one Markdown document. ## Quick Start Create a Mermaid sequence diagram showing the authentication flow between a client, API gateway, and database in my Markdown document.

Frequently Asked Questions about diagrams

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

FAQPage Schema
How do I create a flowchart in Markdown?▼

Use a Mermaid code fence with flowchart syntax, such as flowchart TD followed by node and edge definitions. For complex directed graphs with custom layouts, use Graphviz with a dot code fence instead.

Mermaid vs PlantUML: which should I use for diagrams?▼

Use Mermaid for simple flowcharts, sequence diagrams, and state machines. Use PlantUML when you need UML diagrams with icons, cloud architecture stencils for AWS, Azure, GCP, or Kubernetes, or network topology diagrams.

How do I create a bar chart or line chart in Markdown?▼

Use Vega-Lite with a vega-lite code fence containing a JSON specification. Include the $schema field, inline data values, a mark type like bar or line, and encoding channels mapping fields to x and y axes.

Why is my Mermaid diagram not rendering?▼

Common causes include a space after a period in node labels like [1. Item], unquoted subgraph names containing spaces, or referencing a subgraph display name instead of its ID. Quote node text with spaces and use flowchart instead of graph.

Can I make architecture diagrams with AWS or Kubernetes icons?▼

Yes, PlantUML supports over 9,500 mxgraph stencils. Use prefixes like mxgraph.aws4.lambda_function or mxgraph.kubernetes2.pod, always wrapping the diagram in @startuml and @enduml tags.

What are the limitations of infographic templates?▼

Infographic templates work best with 4-8 items and have structural constraints: compare templates need exactly 2 root items, SWOT requires exactly 4 labeled quadrants, and hierarchy templates support at most 3 nesting levels.