excalidraw-diagram

Generate Excalidraw diagram JSON from natural-language descriptions.

203|27|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/franklee16/academic-research-skills --skill excalidraw-diagram-franklee16
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: excalidraw-diagram
Source: https://github.com/franklee16/academic-research-skills/tree/main/output-tools/excalidraw-diagram-skill-main
Command: npx skills add https://github.com/franklee16/academic-research-skills --skill excalidraw-diagram-franklee16

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

It helps you turn natural-language descriptions into clear Excalidraw diagrams that communicate meaning, relationships, and workflow structure—rather than producing generic labeled boxes.

Core Features & Use Cases

  • Visual-argument diagram generation: Uses design rules that ensure the diagram’s structure maps to the concept being explained.
  • Technical diagram accuracy with evidence artifacts: Encourages researching real specs and including concrete code/JSON/event details for educational value.
  • Multi-zoom composition guidance: Plans summary flow, grouped sections, and detailed evidence elements in one coherent visual system.
  • Render-and-validate workflow support: Includes a Playwright-based pipeline so the agent can catch and fix layout issues before delivery.

Quick Start

Ask your coding agent to create an Excalidraw diagram that explains a system or workflow, for example: "Create an Excalidraw diagram showing how the AG-UI protocol streams events from an AI agent to a frontend UI."

Frequently Asked Questions about excalidraw-diagram

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

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

To generate Excalidraw diagrams from natural language, you provide a text description of a workflow or architecture to your coding agent. The agent outputs structured Excalidraw JSON that maps visual structure to the concept being explained.

What is visual-argument diagram generation for technical architecture?

Visual-argument diagram generation uses design rules to ensure a technical architecture diagram's structure maps directly to the concept being explained. It produces clear visual relationships rather than generic labeled boxes to communicate meaning.

How do I validate Excalidraw JSON layout before delivery?

You validate Excalidraw JSON layout using a Playwright-based render-and-validate pipeline. This automated workflow catches and fixes layout issues in the generated diagram before final delivery.

Can I include concrete code and event details in technical diagrams?

Yes, you can include concrete code, JSON, and event details in technical diagrams. The generation process encourages researching real specs to create evidence artifacts that provide concrete educational value.

Does the Excalidraw diagram generation process support multi-zoom composition?

Yes, the Excalidraw diagram generation process supports multi-zoom composition. It plans summary flows, grouped sections, and detailed evidence elements within one coherent visual system for educational diagrams.

Do I need Playwright to use this Excalidraw diagram generation workflow?

Yes, you need Playwright installed to use the mandatory render-and-validate workflow. It allows the agent to automatically catch and fix layout issues in the generated Excalidraw JSON.