excalidraw-diagram

Convert natural-language descriptions into Excalidraw JSON diagrams with evidence artifacts.

8|1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/ccomkhj/skills --skill excalidraw-diagram-ccomkhj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: excalidraw-diagram
Source: https://github.com/ccomkhj/skills/tree/main/excalidraw-diagram
Command: npx skills add https://github.com/ccomkhj/skills --skill excalidraw-diagram-ccomkhj

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Excalidraw Diagram Skill turns natural-language ideas into clear Excalidraw JSON diagrams that communicate meaning through structure, relationships, and evidence instead of just labeling boxes.

Core Features & Use Cases

  • Visual argument diagrams: Produces diagrams where shapes mirror concepts (e.g., fan-outs for one-to-many, timelines for sequences).
  • Evidence artifacts for technical accuracy: Includes concrete code snippets, JSON/data examples, real event/step names, and other specific proof for technical diagrams.
  • Render-and-validate workflow: Uses a Playwright renderer so the agent can view output as PNG, detect layout defects (overlap, clipping, misrouted arrows), and iterate until it looks right.
  • Brand customization: Centralizes palette/styling in references/color-palette.md so diagrams follow a user’s brand without rewriting logic.

Quick Start

Ask your coding agent: "Create an Excalidraw diagram showing how the AG-UI protocol streams events from an AI agent to a frontend UI, including the actual event names and a small evidence snippet, then render and fix any layout issues until it looks correct."

Frequently Asked Questions about excalidraw-diagram

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

FAQPage Schema
How do I generate architecture diagrams from natural language descriptions?

You can generate architecture diagrams by providing natural-language descriptions to this Skill, which converts them into Excalidraw JSON. It uses a Playwright-based pipeline to render the output and iteratively validate the visual layout.

Can I include real code snippets and JSON payloads in technical diagrams?

Yes, you can include concrete evidence artifacts like code snippets, JSON payload examples, and real event names. The Skill embeds these specific proofs directly within the generated Excalidraw diagrams to ensure technical accuracy.

Does the Excalidraw diagram generation process automatically fix layout issues?

The diagram generation process automatically detects layout defects like overlap, clipping, and misrouted arrows. It renders the Excalidraw JSON as a PNG using Playwright and iterates until the visual output is correct.

How do I customize the color palette for my Excalidraw diagrams?

You customize the color palette by editing the references/color-palette.md file. This centralizes styling so your generated Excalidraw diagrams follow your brand guidelines without requiring changes to the underlying generation logic.

What is the best way to visually explain system workflows and protocol sequences?

The best way to explain system workflows and protocol sequences is to use visual argument diagrams where shapes mirror concepts, such as timelines for sequences or fan-outs for one-to-many relationships, which this Skill generates automatically.

Do I need Playwright installed to render and validate Excalidraw JSON diagrams?

Yes, you need Playwright installed because the render-and-validate workflow depends on it to output PNGs. This allows the agent to visually inspect the Excalidraw diagrams and fix any detected layout defects.