Agent skill · ma08
excalidraw-diagram
Create Excalidraw diagram JSON files that make visual arguments. Use when the user wants to visualize workflows, architectures, or concepts.
What it needs
About 12k tokens when loaded.
What this skill does
Excalidraw Diagram Creator Generate .excalidraw JSON files that argue visually, not just display information. Setup: If the user asks you to set up this skill (renderer, dependencies, etc.), see README.md for instructions. Customization All colors and brand-specific styles live in one file: references/color-palette.md. Read it before generating any diagram and use it as the single source of truth for all color choices — shape fills, strokes, text colors, evidence artifact backgrounds, everything. To make this skill produce diagrams in your own brand style, edit color-palette.md. Everything else in this file is universal design methodology and Excalidraw best practices. --- Core Philosophy Diagrams should ARGUE, not DISPLAY. A diagram isn't formatted text. It's a visual argument that shows relationships, causality, and flow that words alone can't express. The shape should BE the meaning. The Isomorphism Test: If you removed all text, would the structure alone communicate the concept? If not, redesign. The Education Test: Could someone learn something concrete from this diagram, or does it just label boxes? A good diagram teaches—it shows actual formats, real event names, concrete examples. --- Depth Assessment (Do This First) Before designing, determine what level of detail this diagram needs: Simple/Conceptual Diagrams Use abstract shapes when: Explaining a mental model or philosophy The audience doesn't need technical specifics The concept IS the abstraction (e.g., "separation of concerns") Comprehensive/Technical Diagrams Use concrete examples when: Diagramming a real system, protocol, or architecture The diagram will be used to teach or explain (e.g., YouTube video) The audience needs to understand what things actually look like You're showing how multiple technologies integrate For technical diagrams, you MUST include evidence artifacts (see below). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills ma08/excalidraw-diagram--ce6587