USP
Generates editable, animated Excalidraw diagrams from natural language, automating layout and diagram type selection. Provides a hosted URL, animated SVG, and PNG, keeping your workspace clean. The README is comprehensive with clear exampl…
Use cases
- 01Creating study notes and exam revision maps for students.
- 02Designing lesson explainers and concept breakdowns for teachers.
- 03Developing system and API flow diagrams for architects.
- 04Sketching UX flows and wireframes for designers.
- 05Illustrating sales funnels and conversion visuals.
Detected files (1)
SKILL.mdskillShow content (948 bytes)
--- name: hand-drawn-diagrams description: Create hand-drawn Excalidraw diagrams, flows, explainers, wireframes, and page mockups. Default to monochrome sketch output; allow restrained color only for page mockups when the user explicitly wants webpage-like fidelity. --- Follow the instructions in `./workflow.md`. Key references: - `references/index.md` - `references/activation-routing.xml` - `references/fundamental-shapes.md` ## Recommended: Chrome DevTools MCP Install `chrome-devtools-mcp` for fast PNG and animated SVG rendering — uses a real browser, no Playwright install required. ``` npm install -g chrome-devtools-mcp ``` Then add it to your Claude Code MCP config (`~/.claude/settings.json`): ```json { "mcpServers": { "chrome-devtools-mcp": { "command": "npx", "args": ["chrome-devtools-mcp"] } } } ``` Without it, PNG and video rendering falls back to Playwright (slower, requires browser install).
README
hand-drawn-diagrams
AI skill for turning ideas, notes, systems, and flows into hand-drawn diagrams — with a hosted edit URL, animated video, and PNG, all from a single prompt.
Jump to: What this is · Output · Quick start · Credits

Example output
Static PNG — exported on request:

Animated SVG — draws itself stroke by stroke (view):
What this is
hand-drawn-diagrams is an AI skill (for Claude Code, Codex CLI, and compatible agents) that takes a natural language prompt and produces a hand-drawn diagram you can edit, animate, and share — without opening any app.
You describe what you want. The AI picks the right diagram type, draws it in Excalidraw's sketch style, validates the layout, and hands you a live hosted URL. From there you can edit it in a browser, watch it animate, download the source, or export a PNG.
How it's different from using Excalidraw directly
| Excalidraw | hand-drawn-diagrams | |
|---|---|---|
| Starting point | Blank canvas, you draw | Natural language prompt |
| Diagram type | You decide | AI picks the right route (teaching, UX, architecture, funnel…) |
| Layout | You position everything | AI assigns non-overlapping coordinates |
| Animation | Manual or none | Auto-generated animation spec, renders in browser |
| Output | File on disk | Hosted edit URL + animated SVG + PNG on request |
| Workspace | You open the app | Files stay in /tmp/ by default — workspace stays clean |
This skill is not a replacement for Excalidraw — it sits on top of it. Every diagram it produces is a standard .excalidraw file you can open, edit, and own.
Best for
- students: study notes and exam revision maps
- teachers: lesson explainers and concept breakdowns
- architects: system and API flow diagrams
- builders: sequence diagrams and integration maps
- designers: UX flows and wireframes
- product: idea maps and feature flows
- sales: funnel and conversion visuals
- doctors: process and patient-facing explainers
Output
The agent infers what you want from your prompt and routes to the right output automatically:
| What you ask for | What you get |
|---|---|
| "create a diagram" / default | Browser opens to hosted Excalidraw editor — edit, tweak, download |
| "open the animation" | Browser opens animated view — diagram draws itself stroke by stroke |
| "save as excalidraw" | .excalidraw source file saved to your project |
| "save the animation" | .animated.svg saved to your project — plays in any browser |
| "save image" | .png saved to your project |
| "show image" | .png rendered and opened with your system viewer |
Source files go to /tmp/hand-drawn-diagrams/ by default — your workspace stays clean.
Quick start
npx skills add muthuishere/hand-drawn-diagrams
Works for Claude Code, Codex, OpenCode, Windsurf, GitHub Copilot, Cursor, Gemini CLI, and 40+ more agents. Detects which agents you have installed automatically.
For all install options, global vs project scope, and uninstall — see INSTALL.md.
Credits and acknowledgements
This skill stands on the shoulders of excellent open-source work:
-
Excalidraw — the open-source virtual whiteboard that powers the hand-drawn visual style and the hosted editor. All diagrams produced by this skill are standard Excalidraw files. GitHub: excalidraw/excalidraw
-
excalidraw-animate by @dai-shi — the animation library that renders Excalidraw diagrams as SVGs that draw themselves stroke by stroke. The animated SVG output in this skill is powered by this library.
License
MIT — see LICENSE.