@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.

View in AI SkillSafe app
16 scan findings
0 downloads
0 stars
0 demos
SKILL.md
namehand-drawn-diagrams
descriptionCreate 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.

Embed badges

Add these to your README to show the skill's verification status.

SkillSafe verified badge
Verified badge
[![SkillSafe verified badge](https://api.skillsafe.ai/v1/badge/@muthuishere/hand-drawn-diagrams/verified)](https://skillsafe.ai/skill/@muthuishere/hand-drawn-diagrams/)
Installs badge
Installs badge
[![Installs badge](https://api.skillsafe.ai/v1/badge/@muthuishere/hand-drawn-diagrams/installs)](https://skillsafe.ai/skill/@muthuishere/hand-drawn-diagrams/)
Scan badge
Scan badge
[![Scan badge](https://api.skillsafe.ai/v1/badge/@muthuishere/hand-drawn-diagrams/scan)](https://skillsafe.ai/skill/@muthuishere/hand-drawn-diagrams/)
Eval pass rate badge
Eval pass rate
[![Eval pass rate badge](https://api.skillsafe.ai/v1/badge/@muthuishere/hand-drawn-diagrams/eval)](https://skillsafe.ai/skill/@muthuishere/hand-drawn-diagrams/)