Sandbox
@muthuishere/hand-drawn-diagrams

Hand-drawn diagram skill for Claude Code and Codex

This skill routes a prompt to the right Excalidraw-style diagram type, lays it out, validates it, and returns editable output. It can also produce an animated SVG and a PNG, so you can share the diagram in browser or file form.

69 stars13 forksPythonUpdated 7d ago
Who it's for

Builders who want Claude Code, Codex, Cursor, or other agents to create editable diagrams from a prompt.

What it delivers

You can go from notes or a rough idea to a shareable diagram, instead of drawing it by hand.

What it does

Prompt-to-diagram routing

Chooses a diagram type from the prompt, such as architecture, workflow, UX, teaching, or funnel diagrams.

Excalidraw output

Creates standard `.excalidraw` files that you can open, edit, and keep owning in the browser.

Animated SVG rendering

Generates a stroke-by-stroke animated SVG that plays in the browser.

PNG export

Exports a static PNG on request for sharing or documentation.

Layout validation

Checks the diagram layout so elements do not overlap and the result stays readable.

Hosted edit flow

Hands back a live hosted URL so you can edit the diagram without starting from a blank canvas.

How to get it

  1. 1Run
    npx skills add muthuishere/hand-drawn-diagrams

README

hand-drawn-diagrams

Discord

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

Demo

Example output

Static PNG — exported on request:

Example diagram

Animated SVG — draws itself stroke by stroke (view):

Exam revision diagram

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

Excalidrawhand-drawn-diagrams
Starting pointBlank canvas, you drawNatural language prompt
Diagram typeYou decideAI picks the right route (teaching, UX, architecture, funnel…)
LayoutYou position everythingAI assigns non-overlapping coordinates
AnimationManual or noneAuto-generated animation spec, renders in browser
OutputFile on diskHosted edit URL + animated SVG + PNG on request
WorkspaceYou open the appFiles 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 forWhat you get
"create a diagram" / defaultBrowser 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.

Community

Questions, ideas, or built something with this? Join AgentNexus — a Discord for people building with AI agents and open tools. This project lives in #hand-drawn-diagrams.

License

MIT — see LICENSE.


Built and maintained by deemwar — 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

Files in the repo

Repository payload21 top-level entries
  • .github
  • assets
  • docs
  • installscripts
  • references
  • scripts
  • steps
  • .gitattributes
  • .gitignore
  • AGENTS.md
  • CLAUDE.md
  • install.cmd
  • INSTALL.md
  • install.sh
  • LICENSE
  • MANUAL-INSTALL.md
  • README.md
  • SKILL.md
  • uninstall.cmd
  • uninstall.sh
  • workflow.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More skills

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

117k
1 add
Vincentwei1021/
anything2explainer

Topic in, narrated explainer video out. A Claude Code / Codex skill that turns any topic into a black-canvas motion-graphics explainer video with TTS voiceover, subtitles and a chapter progress bar. Chinese or English; every frame drawn in code with Remotion.

666

Taste-Skill - gives your AI good taste. stops the AI from generating boring, generic slop

86k

Agent skill for beautiful, verifiable architecture, workflow, sequence, data-flow, and lifecycle diagrams—self-contained HTML with motion and crisp export.

57k