excalidraw-skill

Create and validate editable Excalidraw diagrams from Mermaid flowcharts and references.

2|Updated May 5, 2026
One-click install
npx skills add https://github.com/OrestesK/pi --skill excalidraw-skill-orestesk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: excalidraw-skill
Source: https://github.com/OrestesK/pi/tree/main/skills/excalidraw-skill
Command: npx skills add https://github.com/OrestesK/pi --skill excalidraw-skill-orestesk

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill turns architectural concepts, workflows, Mermaid diagrams, and visual references into clear, editable Excalidraw diagrams while preventing common problems such as cluttered layouts, unreadable labels, broken arrow topology, and unvalidated exports.

Core Features & Use Cases

  • Diagram Creation and Refinement: Build, update, arrange, query, and delete Excalidraw elements using MCP tools, CLI commands, or REST APIs.
  • Reference-Matched Design: Inspect supplied PNG or native Excalidraw references and apply their visual traits, including typography, spacing, shapes, colors, boundaries, and connector styles.
  • Mermaid Conversion and Export: Convert Mermaid flowcharts into Excalidraw scenes and export native, PNG, or SVG artifacts.
  • Quality Validation: Apply semantic reduction, complexity budgets, staged construction, native scene auditing, target-scale checks, grayscale review, and adversarial visual inspection.
  • Use Case: Create a CI/CD architecture diagram from GitHub through GitHub Actions and a container registry to Kubernetes, then validate its topology and readability at full and reduced sizes.

Quick Start

Use the Excalidraw skill to create a clean, left-to-right architecture diagram from the provided system description and validate the exported scene for readability and correct arrow bindings.

Frequently Asked Questions about excalidraw-skill

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

FAQPage Schema
How do I convert Mermaid flowcharts to editable Excalidraw diagrams?

The Skill converts Mermaid flowcharts into Excalidraw scenes by parsing the input syntax and applying staged canvas construction with bound semantic connectors. This produces an editable diagram that preserves the original flowchart topology.

What is the best way to validate technical diagrams for readability and topology?

Validating technical diagrams requires structural scene auditing, target-scale checks, and grayscale review. The Skill performs these checks alongside adversarial visual inspection to ensure architecture diagrams remain readable and have correct arrow bindings at native and reduced sizes.

Can I use visual references to match Excalidraw diagram styles?

Yes, the Skill inspects supplied PNG or native Excalidraw references and applies their visual traits to the canvas. It matches typography, spacing, shapes, colors, boundaries, and connector styles to ensure the new diagram aligns with the provided visual reference.

How do I prevent cluttered layouts and broken arrows in architecture diagrams?

Preventing cluttered layouts and broken arrows involves applying complexity controls, staged construction, and bound semantic connectors. The Skill enforces these constraints during canvas automation to maintain clear, validated technical diagrams with correct topology.

Does the Excalidraw canvas automation support native PNG and SVG export?

Yes, canvas automation supports native PNG and SVG export alongside native Excalidraw artifacts. The Skill generates these exports after refining the scene and validating the visual output through reduced-scale and grayscale reviews.

Do I need MCP tools or CLI commands to automate Excalidraw diagram creation?

You can automate Excalidraw diagram creation using MCP tools, CLI commands, or REST APIs. The Skill leverages these interfaces to build, arrange, query, and delete Excalidraw elements during the staged canvas construction process.