excalidraw

Generate hand-drawn Excalidraw JSON diagrams for architecture, flowcharts, and sequence diagrams.

Updated Jul 10, 2026
One-click install
npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill excalidraw-avatar-arts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: excalidraw
Source: https://github.com/AvaTar-ArTs/.Agent-skills/tree/main/skills/creative/excalidraw
Command: npx skills add https://github.com/AvaTar-ArTs/.Agent-skills --skill excalidraw-avatar-arts

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires cryptography, and includes scripts (resource) and references (resource) components.

What problem does it solve? Creating diagrams usually requires opening a drawing tool and manually placing shapes. This Skill lets you produce hand-drawn style diagrams as plain Excalidraw JSON files that open directly on excalidraw.com, with no accounts, API keys, or rendering libraries. ## Core Features & Use Cases - JSON Diagram Generation: Write standard Excalidraw element JSON (rectangles, ellipses, diamonds, arrows, bound text labels) and save it as a .excalidraw file. - Shareable Links: Upload diagrams to excalidraw.com with client-side AES-GCM encryption via the included scripts/upload.py to get a shareable URL. - Reference Guides: Built-in color palettes, dark-mode theming rules, and complete copy-pasteable examples (flowcharts, process diagrams, UML sequence diagrams). - Use Case: Ask for a system architecture diagram and receive a .excalidraw file you can drag onto excalidraw.com, plus an optional shareable link for your team. ## Quick Start Ask the agent to create an Excalidraw diagram of your system architecture and save it as a .excalidraw file.

Frequently Asked Questions about excalidraw

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create an Excalidraw diagram from JSON?

Write an array of Excalidraw element objects (rectangles, arrows, text) and wrap it in the standard envelope with type, version, source, elements, and appState keys. Save it as a .excalidraw file and drag it onto excalidraw.com to view and edit.

How do I add text labels to Excalidraw shapes?

Use container binding: the shape needs a boundElements array referencing the text element, and the text element needs a containerId pointing back to the shape. The label property does not exist in Excalidraw and is silently ignored.

How do I share an Excalidraw diagram with a link?

Run the included upload.py script with your .excalidraw file path. It encrypts the file client-side with AES-GCM, uploads it to excalidraw.com without an account, and prints a shareable URL containing the decryption key.

Why is my Excalidraw text invisible or blank?

Blank shapes usually mean the label property was used instead of container binding. Invisible text on dark backgrounds happens when the default #1e1e1e strokeColor is kept; set text strokeColor to #e5e5e5 for dark mode diagrams.

What dependencies does the Excalidraw upload script need?

The upload script requires only the cryptography pip package for AES-GCM encryption. Everything else uses Python standard library modules like zlib, json, and urllib, and no excalidraw.com account is needed.