@muthuishere/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.
| 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
- 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). - Draw — Read
./steps/step-02-draw.md. Design the diagram using the shared shape grammar (references/fundamental-shapes.md), then write the.excalidrawJSON file with a non-empty elements array to/tmp/hand-drawn-diagrams/<slug>/. - Validate & Deliver — Read
./steps/step-03-validate.md. Runscripts/validate_excalidraw.py, thenscripts/open_diagram.pyto 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
.excalidrawfiles 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 indexreferences/activation-routing.xml— route selection rules and delivery modesreferences/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.
Loading...
Select a file to preview
Analyzing security...
Checking scan reports and verification data.
Bill of Materials
Everything this skill can do — files, network, commands, and more.