Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/muthuishere--hand-drawn-diagrams/badge.svg)](/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

i

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)

  1. ---
  2. name: hand-drawn-diagrams
  3. 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."
  4. ---
  5. Follow the instructions in `./workflow.md`.
  6. ## Workflow
  7. 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).
  8. 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>/`.
  9. 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.
  10. ## Key Rules
  11. - Hand-drawn style, same sketch font, monochrome by default
  12. - Labels: 1–5 words per shape; max 3 short bullets per container
  13. - Write `.excalidraw` files to `/tmp/`, not the user's workspace (unless they ask)
  14. - Always validate before generating URLs — never share an empty diagram
  15. - Rendering priority: Chrome DevTools MCP (fast) → Playwright (fallback)
  16. ## References
  17. - `references/index.md` — full reference index
  18. - `references/activation-routing.xml` — route selection rules and delivery modes
  19. - `references/fundamental-shapes.md` — core shape language
  20. ## Optional: Chrome DevTools MCP
  21. 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)

  1. # hand-drawn-diagrams
  2. [![Discord](https://img.shields.io/badge/AgentNexus-join%20the%20community-5865F2?logo=discord&logoColor=white)](https://discord.gg/V9C2kvHC8D)
  3. 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.
  4. **Jump to:** [What this is](#what-this-is) · [Output](#output) · [Quick start](#quick-start) · [Credits](#credits-and-acknowledgements)
  5. ![Demo](assets/demo.gif)
  6. ### Example output
  7. Static PNG — exported on request:
  8. ![Example diagram](assets/diagram.png)
  9. Animated SVG — draws itself stroke by stroke ([view](assets/diagram.animated.svg)):
  10. ![Exam revision diagram](assets/thermal-physics-exam-revision.animated.svg)
  11. ## What this is
  12. **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.
  13. 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.
  14. ## How it's different from using Excalidraw directly
  15. | | Excalidraw | hand-drawn-diagrams |
  16. |---|---|---|
  17. | Starting point | Blank canvas, you draw | Natural language prompt |
  18. | Diagram type | You decide | AI picks the right route (teaching, UX, architecture, funnel…) |
  19. | Layout | You position everything | AI assigns non-overlapping coordinates |
  20. | Animation | Manual or none | Auto-generated animation spec, renders in browser |
  21. | Output | File on disk | Hosted edit URL + animated SVG + PNG on request |
  22. | Workspace | You open the app | Files stay in `/tmp/` by default — workspace stays clean |
  23. 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.
  24. ## Best for
  25. - students: study notes and exam revision maps
  26. - teachers: lesson explainers and concept breakdowns
  27. - architects: system and API flow diagrams
  28. - builders: sequence diagrams and integration maps
  29. - designers: UX flows and wireframes
  30. - product: idea maps and feature flows
  31. - sales: funnel and conversion visuals
  32. - doctors: process and patient-facing explainers
  33. ## Output
  34. The agent infers what you want from your prompt and routes to the right output automatically:
  35. | What you ask for | What you get |
  36. |---|---|
  37. | "create a diagram" / default | Browser opens to hosted Excalidraw editor — edit, tweak, download |
  38. | "open the animation" | Browser opens animated view — diagram draws itself stroke by stroke |
  39. | "save as excalidraw" | `.excalidraw` source file saved to your project |
  40. | "save the animation" | `.animated.svg` saved to your project — plays in any browser |
  41. | "save image" | `.png` saved to your project |
  42. | "show image" | `.png` rendered and opened with your system viewer |
  43. Source files go to `/tmp/hand-drawn-diagrams/` by default — your workspace stays clean.
  44. ## Quick start
  45. ```bash
  46. npx skills add muthuishere/hand-drawn-diagrams
  47. ```
  48. Works for Claude Code, Codex, OpenCode, Windsurf, GitHub Copilot, Cursor, Gemini CLI, and 40+ more agents. Detects which agents you have installed automatically.
  49. For all install options, global vs project scope, and uninstall — see [INSTALL.md](INSTALL.md).
  50. ## Credits and acknowledgements
  51. This skill stands on the shoulders of excellent open-source work:
  52. - **[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.
  53. GitHub: [excalidraw/excalidraw](https://github.com/excalidraw/excalidraw)
  54. - **[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.
  55. ## Community
  56. Questions, ideas, or built something with this? Join **[AgentNexus](https://discord.gg/V9C2kvHC8D)** — a Discord
  57. for people building with AI agents and open tools. This project lives in **#hand-drawn-diagrams**.
  58. ## License
  59. MIT — see [LICENSE](LICENSE).
  60. ---
  61. Built and maintained by **[deemwar](https://examples.deemwar.com)** — we build messaging and
  62. browser automation, and the plumbing that keeps it delivering when it silently stops.
  63. Need help with this, or something like it in production? **io@deemwar.com**

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.