Generates Excalidraw diagrams from natural language descriptions, enabling coding agents to create visually argumentative and evidence-rich technical diagrams. It targets agents that support skills, offering a practical solution for complex visual communication beyond simple box-and-arrow representations.

How It Works

This skill employs a novel approach where diagram elements visually represent the concepts they depict, such as using fan-outs for one-to-many relationships or timelines for sequences. Diagrams can incorporate "evidence artifacts" like code snippets and JSON payloads. A Playwright-based render pipeline provides built-in visual validation, allowing agents to iteratively detect and correct layout issues like overlapping text or misaligned arrows before final output.

Quick Start & Requirements

• Installation: Clone the repository and copy the excalidraw-diagram-skill directory into your project's .claude/skills/ directory.
• Setup:
  • Option A: Instruct your coding agent to set up the renderer by following instructions in SKILL.md.
  • Option B: Manually navigate to .claude/skills/excalidraw-diagram/references, run uv sync, and then uv run playwright install chromium.
• Prerequisites: Python, uv package manager, and Playwright (for rendering and validation).
• Customization: Brand colors can be customized by editing references/color-palette.md.

Highlighted Details

• Diagrams are designed to "argue visually," mirroring concepts rather than using uniform grids.
• Includes "evidence artifacts" such as real code snippets and JSON payloads within diagrams.
• Features a Playwright-based visual validation pipeline for automated layout issue detection and correction.
• Supports brand customization through a dedicated color palette file.

Maintenance & Community

No specific details regarding contributors, sponsorships, or community channels (like Discord/Slack) are provided in the README excerpt.

Licensing & Compatibility

The license type is not explicitly stated in the provided README excerpt. Compatibility for commercial use or closed-source linking is therefore undetermined.

Limitations & Caveats

The skill's effectiveness relies on the underlying coding agent's natural language understanding and Excalidraw generation capabilities. Setup requires specific tooling like uv and Playwright. The absence of a stated license poses a significant adoption blocker for many use cases.