Skip to main content
skill CX Codex

diagram-design · vstorm-co — Claude Code skill for research diagrams

The diagram-design skill guides research diagram creation on an Excalidraw canvas through MCP. Use it to map comparisons, processes, architectures, or timelines.

MIT ★ 1,125 updated 2026-10-27

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add vstorm-co/pydantic-deepagents --skill diagram-design -a claude-code
Open on GitHub

What diagram-design does

The skill helps decide when research findings call for a diagram: compare options, map a multi-step process, or show how system components relate. It also suggests layouts, from grids for comparisons to radial maps for concepts.

Its workflow uses Excalidraw MCP tools to create and arrange elements, inspect the scene with describe_scene, revise text or placement, and group related items. The guide covers colors, shapes, labels, arrows, and spacing. Avoid create_from_mermaid: the instructions say it produces an invisible result.

The canvas syncs live, so the skill advises against exporting diagrams or sharing links. Excalidraw MCP tools are needed to create and inspect diagram elements.

What it helps with

  • compare options in a single diagram
  • map the stages of a process
  • show system components and their relationships
  • arrange research events on a timeline
  • turn findings into a concept map

Example prompts for the agent

  • Compare the options and show their advantages, limits, and verdict in an Excalidraw diagram.
  • Draw the system architecture from the component and relationship descriptions.
  • Arrange the research events chronologically as a timeline.

How to install diagram-design

1Skills CLI (Vercel)

npx skills add vstorm-co/pydantic-deepagents --skill diagram-design -a claude-code

2Manually: put the files in place

~/.claude/skills/diagram-design/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/diagram-design/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about diagram-design

How do I install diagram-design in Claude Code?

Run npx skills add vstorm-co/pydantic-deepagents --skill diagram-design -a claude-code, then use ~/.claude/skills/diagram-design/SKILL.md.

What does diagram-design do?

It guides the creation of research diagrams in Excalidraw, covering diagram choice, layout, element creation, inspection, colors, shapes, and arrows.

Why should I avoid create_from_mermaid?

The guide warns that this method produces an invisible result. It recommends batch_create_elements with element JSON instead.

Source text

SKILL.md · MIT
---
name: diagram-design
description: Best practices for creating research diagrams with Excalidraw MCP tools
---

# Diagram Design Guide for Research

## When to Create Diagrams

Create a diagram when your research findings involve:
- **Comparing 3+ options** — comparison table or matrix diagram
- **Process with 4+ steps** — flowchart or sequence diagram
- **System with multiple components** — architecture diagram
- **Chronological events** — timeline
- **Hierarchical relationships** — tree or mind map
- **Data flows** — data flow diagram

## Excalidraw Workflow

1. **Plan the diagram** — decide type, elements, and layout before creating
2. **Create elements** — use `create_element` or `batch_create_elements`
3. **Arrange** — use `align_elements` and `distribute_elements` for clean layout
4. **Inspect** — use `describe_scene` to verify the diagram looks right
5. **Adjust** — use `update_element` to fix positioning or text
6. **Group** — use `group_elements` to lock related items together

> **Note:** Do NOT export or share links — the user sees a live embedded canvas that auto-syncs.

## Color Palette

Use consistent colors across diagrams:

| Purpose | Color | Hex |
|---------|-------|-----|
| Primary concepts | Blue | #1971c2 |
| Positive / supported | Green | #2f9e44 |
| Negative / limitations | Red | #e03131 |
| Warning / caveats | Orange | #e8590c |
| Neutral / context | Gray | #868e96 |
| Highlight / focus | Yellow | #f08c00 |

## Layout Patterns

- **Top-to-bottom**: Process flows, decision trees, timelines
- **Left-to-right**: Comparisons, before/after, pipelines
- **Radial / center-out**: Concept maps, mind maps
- **Grid**: Feature matrices, comparison tables

## Element Guidelines

### Text
- Use short labels (2-4 words per element)
- Title font size: 20-24px
- Label font size: 14-16px
- Add detail in sub-labels, not element titles

### Shapes
- **Rectangles**: Processes, components, entities
- **Diamonds**: Decision points
- **Ellipses**: Start/end points, concepts
- **Rectangles with rounded corners**: Groups, categories

### Arrows
- **Solid arrows**: Direct relationships, data flow
- **Dashed arrows**: Optional paths, indirect relationships
- Label arrows to clarify the relationship

### Spacing
- 40px minimum between elements
- 80px between groups
- Consistent spacing within a group

## Diagram Types for Research

### Comparison Diagram
```
[Option A]  [Option B]  [Option C]
   |            |            |
[Pros]      [Pros]      [Pros]
[Cons]      [Cons]      [Cons]
   |            |            |
   └──── [Verdict] ─────────┘
```

### Architecture Diagram
```
┌─────────────────────────────┐
│        [System Name]         │
│  ┌──────┐  ┌──────┐        │
│  │Comp A│──│Comp B│        │
│  └──────┘  └──┬───┘        │
│               │              │
│          ┌────▼────┐        │
│          │ Comp C  │        │
│          └─────────┘        │
└─────────────────────────────┘
```

### Timeline
```
[2020]──[2021]──[2022]──[2023]──[2024]──[2025]
  │       │       │       │       │       │
 Event   Event   Event   Event   Event   Event
```

## Tips

- Always call `describe_scene` after creating elements to verify layout
- Use `batch_create_elements` for efficiency (multiple elements at once)
- Group related elements before aligning for cleaner organization
- Do NOT export or share links — the live embedded canvas auto-syncs for the user
- NEVER use `create_from_mermaid` — it produces invisible results. Always use `batch_create_elements` with element JSON instead

© vstorm-co · MIT · vstorm-co/pydantic-deepagents

Similar skills

All skills for Design →

diagram-design by other authors comes first.

diagram-design cathrynlavery diagram-design is a Claude Code skill that builds editorial diagrams as standalone HTML files with inline SVG. It covers 51 visual types under a project-specific style guide. CX Codex +1 30,900installs diagram-design-editorial reason-machines diagram-design-editorial — a skill that turns a short description into an HTML+SVG diagram for posts and docs. Thirteen types, no Mermaid, no build step, styling matched to your site. CX Codex +1 440installs excalidraw-diagram-generator official github excalidraw-diagram-generator is a GitHub Copilot skill that turns plain-language descriptions into Excalidraw diagrams of processes, system structure, and relationships. CX Codex +1 31,639installs baoyu-diagram JimLiu baoyu-diagram builds system and workflow diagrams as self-contained SVGs with dark and light themes, exporting both versions to @2x PNGs. CX Codex +1 16,200installs excalidraw-diagram coleam00 excalidraw-diagram generates .excalidraw JSON diagram files for technical architectures and workflows. Helps turn system specs or logic into diagrams with real data examples. CX Codex +1 8,900installs diagram-creator claude-office-skills diagram-creator generates system diagrams and flowcharts using Mermaid, PlantUML, and D2 syntax. It helps document APIs, database relations, and service architecture. CX Codex +1 5,200installs html-diagram plannotator Generates standalone interactive HTML diagrams without external services or build steps. Helps visualize component topology, state transitions, timelines, and quantitative structures. CX Codex +1 4,600installs

From the same set14

The whole set →
environment-discovery The environment-discovery skill trains Claude Code to systematically explore unfamiliar environments before making changes. It checks file structure, data formats, available tools, and existing code—saving debugging time. CX Codex +1 ★ 1,125repo stars report-writing report-writing provides guidelines for structuring analytical reports, drafting stand-alone executive summaries, and citing sources. CX Codex +1 ★ 1,125repo stars build-and-compile The build-and-compile skill helps Claude Code choose build commands from a project's files and troubleshoot compiler or dependency errors. Use it when a build fails or the project setup is unclear. CX Codex +1 ★ 1,125repo stars research-methodology research-methodology — a skill with methodology for structured research: three-phase search, source reliability ranking, and note-taking with confidence levels for each finding. CX Codex +1 ★ 1,125repo stars performant-code performant-code guides Claude Code to write fast routines for large files and strict memory caps. Helps prevent runtime timeouts on heavy workloads. CX Codex +1 ★ 1,125repo stars data-formats The data-formats skill guides file inspection before parsing, from checking binary signatures to sampling large structured files. Use it when a file’s format is unclear. CX Codex +1 ★ 1,125repo stars systematic-debugging systematic-debugging walks the agent through five debugging steps, from reproducing the failure to confirming the fix. Useful once random edits stop working. CX Codex +1 ★ 1,125repo stars verification-strategy verification-strategy — a structured checklist skill for Claude Code to audit file outputs, compiler flags, exit codes, and edge cases before declaring a task finished. CX Codex +1 ★ 1,125repo stars

Project sponsors

Companies that keep this analytics open