hand-drawn-diagrams
"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. Use when the user asks for a diagram, flowchart, wireframe, sketch, visual explanation, mind map, architecture overview, or any Excalidraw-based drawing."
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/muthuishere--hand-drawn-diagrams)HTML
<a href="/listings/muthuishere--hand-drawn-diagrams"><img src="/api/listings/muthuishere--hand-drawn-diagrams/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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](INSTALL.md).
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 30 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- 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. Use when the user asks for a diagram, flowchart, wireframe, sketch, visual explanation, mind map, architecture overview, or any Excalidraw-based drawing."
- ---
- Follow the instructions in `./workflow.md`.
- ## Workflow
- 1. **Route** — Read `./steps/step-01-route.md`. Pick one diagram type from the routing table (`references/activation-routing.xml`) based on user intent (teach, brainstorm, UX flow, funnel, technical explainer, medical, creative, or page mockup).
- 2. **Draw** — Read `./steps/step-02-draw.md`. Design the diagram using the shared shape grammar (`references/fundamental-shapes.md`), then write the `.excalidraw` JSON file with a non-empty elements array to `/tmp/hand-drawn-diagrams/<slug>/`.
- 3. **Validate & Deliver** — Read `./steps/step-03-validate.md`. Run `scripts/validate_excalidraw.py`, then `scripts/open_diagram.py` to generate a hosted edit URL and open it in the browser. Offer animation and PNG as follow-ups.
- ## Key Rules
- - Hand-drawn style, same sketch font, monochrome by default
- - Labels: 1–5 words per shape; max 3 short bullets per container
- - Write `.excalidraw` files to `/tmp/`, not the user's workspace (unless they ask)
- - Always validate before generating URLs — never share an empty diagram
- - Rendering priority: Chrome DevTools MCP (fast) → Playwright (fallback)
- ## References
- - `references/index.md` — full reference index
- - `references/activation-routing.xml` — route selection rules and delivery modes
- - `references/fundamental-shapes.md` — core shape language
- ## Optional: Chrome DevTools MCP
- For fast PNG and animated SVG rendering, install `chrome-devtools-mcp` (uses a real browser, no Playwright needed). See `INSTALL.md` for setup. Without it, rendering falls back to Playwright.
README.md · README · 99 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # hand-drawn-diagrams
- [](https://discord.gg/V9C2kvHC8D)
- 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](#what-this-is) · [Output](#output) · [Quick start](#quick-start) · [Credits](#credits-and-acknowledgements)
- 
- ### Example output
- Static PNG — exported on request:
- 
- Animated SVG — draws itself stroke by stroke ([view](assets/diagram.animated.svg)):
- 
- ## 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
- ```bash
- 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](INSTALL.md).
- ## Credits and acknowledgements
- This skill stands on the shoulders of excellent open-source work:
- - **[Excalidraw](https://excalidraw.com/)** — 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](https://github.com/excalidraw/excalidraw)
- - **[excalidraw-animate](https://github.com/dai-shi/excalidraw-animate)** by [@dai-shi](https://github.com/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.
- ## Community
- Questions, ideas, or built something with this? Join **[AgentNexus](https://discord.gg/V9C2kvHC8D)** — a Discord
- for people building with AI agents and open tools. This project lives in **#hand-drawn-diagrams**.
- ## License
- MIT — see [LICENSE](LICENSE).
- ---
- Built and maintained by **[deemwar](https://examples.deemwar.com)** — we build messaging and
- browser automation, and the plumbing that keeps it delivering when it silently stops.
- Need help with this, or something like it in production? **io@deemwar.com**
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.