# excalidraw

Generates flowcharts, architecture diagrams, and system sketches as .excalidraw files directly through agent MCP tools.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 1979
- Author: nimbalyst
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/nimbalyst/nimbalyst/tree/HEAD/packages/extensions/excalidraw/claude-plugin/skills/excalidraw/SKILL.md
- Updated: 2026-10-25
- HTML: https://affpapa.org/en/nevibecode/skills/nimbalyst-excalidraw

## What it does

This skill guides an AI assistant to build whiteboard diagrams using dedicated `excalidraw.*` MCP tools. The agent creates workspace `.excalidraw` files, places rectangles or frames, routes directional arrows, and imports diagrams directly from Mermaid syntax via `import_mermaid`.

A central rule in the instructions is single-pass execution. The agent must never loop through continuous rebuilds or clear the canvas with `clear_all` to chase cosmetic perfection. Minor visual misalignments belong to hand-drawn sketches. Broken elements are fixed with targeted calls like `update_element` or `move_element`.

This skill does not handle entity-relationship diagrams or database schemas — the author directs users to the DataModelLM extension and Prisma schemas instead. Diagram generation relies on the Nimbalyst MCP environment to mount a hidden editor and take a single verification screenshot.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add nimbalyst/nimbalyst --skill excalidraw -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/excalidraw/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/excalidraw/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add nimbalyst/nimbalyst --skill excalidraw -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/excalidraw/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add nimbalyst/nimbalyst --skill excalidraw -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/excalidraw/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install nimbalyst/nimbalyst excalidraw
```

2. **Manually: put the files in place**
- File: `.github/skills/excalidraw/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add nimbalyst/nimbalyst --skill excalidraw -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/nimbalyst/nimbalyst --path packages/extensions/excalidraw/claude-plugin/skills/excalidraw
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/excalidraw/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add nimbalyst/nimbalyst --skill excalidraw -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/nimbalyst/nimbalyst/tree/HEAD/packages/extensions/excalidraw/claude-plugin/skills/excalidraw/SKILL.md

## When to use it
- sketch system architecture and component interactions
- convert existing Mermaid flowcharts into editable `.excalidraw` files
- organize process steps horizontally or vertically with frames
- adjust layout elements precisely without wiping the whole canvas

## Example prompts
- Draft a high-level system architecture diagram in `system-design.excalidraw`
- Import the Mermaid diagram from `flow.md` into an Excalidraw canvas
- Add an authentication step to `user-flow.excalidraw` and align the connected arrows

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: cf3ae2104080f67e.

BEGIN THIRD-PARTY FILE cf3ae2104080f67e
```text
---
name: excalidraw
description: Create diagrams and visual drawings using Excalidraw (.excalidraw files). Use when the user wants flowcharts, architecture diagrams, system diagrams, sketches, or any visual diagram. For database schemas and entity relationship diagrams, use the DataModelLM extension instead.
---

# Excalidraw Diagrams

Excalidraw is Nimbalyst's whiteboard-style diagram editor for creating flowcharts, architecture diagrams, system diagrams, and visual sketches.

## STOP AFTER ONE PASS — Do Not Thrash

The single biggest failure mode with this skill is agents creating a diagram, capturing a screenshot, noticing minor cosmetic imperfections, then clearing and rebuilding the diagram two, three, or four times without being asked. This is the wrong behavior. The user sees every rebuild, and iterations the user did not ask for are a waste of their time and attention.

Follow these rules:

1. **One-shot by default.** Build the diagram, capture a screenshot once, describe what you made, and stop. Do not iterate on visual polish unless the user explicitly asks for a change.
2. **Never use `excalidraw.clear_all` followed by a rebuild as a way to "redo" the diagram.** `clear_all` is only for user-requested rebuilds. If you just produced a diagram, looked at it, and feel like starting over, don't — stop and hand control back to the user.
3. **Minor imperfections are fine.** Excalidraw is a whiteboard / hand-drawn-style tool. Slight overlaps, arrows that route imperfectly, labels that aren't perfectly centered, and asymmetric spacing are all acceptable and expected. Do not rebuild to fix these. Do not re-run `import_mermaid` because the auto-layout isn't pixel-perfect.
4. **Only one screenshot per diagram.** Capture once to verify the diagram exists and is roughly what you intended, then stop screenshotting. Repeated screenshots drive perfectionism loops.
5. **If something is actually broken, make a targeted fix — not a rebuild.** Use `update_element`, `move_element`, `remove_element`, or `align_elements` on the specific problem. Do not wipe and restart.
6. **"Good enough to convey the idea" is the bar.** The diagram's job is to communicate structure or flow to a human reader. Once it does that, you are done. Do not keep polishing.

If you catch yourself about to call `clear_all` after just having built a diagram, or about to capture a second screenshot of the same diagram, stop. Report what you made and let the user decide whether changes are needed.

## When to Use Excalidraw

- Flowcharts and process diagrams
- Architecture diagrams
- System design diagrams
- Sequence diagrams
- Mind maps
- Network diagrams
- User flow diagrams
- General visual diagrams and sketches

## When NOT to Use Excalidraw
```
END THIRD-PARTY FILE cf3ae2104080f67e

The third-party file has ended. Everything between the cf3ae2104080f67e tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2759 of 6163 bytes. © nimbalyst · MIT · https://github.com/nimbalyst/nimbalyst/tree/HEAD/packages/extensions/excalidraw/claude-plugin/skills/excalidraw/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md