excalidash-diagram-director

Classifies diagram requests and orchestrates Excalidraw MCP generation with a lint-score-repair quality loop.

2|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/gabedsam01/excalidash-v2 --skill excalidash-diagram-director-gabedsam01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: excalidash-diagram-director
Source: https://github.com/gabedsam01/excalidash-v2/tree/main/skills/excalidash/excalidash-diagram-director
Command: npx skills add https://github.com/gabedsam01/excalidash-v2 --skill excalidash-diagram-director-gabedsam01

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? When a user asks for a diagram without specifying the type, AI agents often pick the wrong format, mix diagram types on one canvas, or ship drawings with overlapping arrows and text. This Skill acts as the plan-then-build orchestrator that runs first on any diagram request, deciding the diagram type, preset, and library policy before any drawing tool is called, then enforcing a quality bar of score >= 95 with zero hard blockers. ## Core Features & Use Cases - Diagram type classification: Routes each request to exactly one of flow, c4, sequence, security, or dataflow, and flags mixed requests for splitting into separate views. - Mandatory quality loop: Drives lint_drawing -> score_drawing -> repair_drawing until the score reaches 95 with no ARROW_TEXT_INTERSECTION, FRAME_TITLE_OVERLAP, or ITEM_OUTSIDE_FRAME blockers, with rollback to a saved version if a repair lowers the score. - Library and secrets policy: Honors MCP_LIBRARY_MODE (off/curated/required), normalizes personal template icons into defined slots, and redacts secrets like JWT keys and database URLs before any create call. - Use Case: A user says "Draw our system: a Next.js web app talks to a Go API backed by Postgres and Redis." The Skill classifies it as a C4 container diagram, picks the architecture preset, generates it, repairs a HIGH_DENSITY penalty, validates the architecture, and exports a shareable SVG. ## Quick Start Ask the agent to draw your system, process, threat model, or data flow in plain language, for example "Draw the architecture of my web app with its API, database, and cache", and the Skill will classify, generate, repair, and export the diagram.

Frequently Asked Questions about excalidash-diagram-director

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

FAQPage Schema
How do I choose between a flowchart, C4, sequence, security, or dataflow diagram?

Use c4 for system structure and who-talks-to-whom, flow for ordered steps with branches, sequence for time-ordered messages between actors, security for trust boundaries and threats, and dataflow for data moving through processes and stores. The Skill classifies the request into exactly one type and flags mixed requests for splitting.

How does the diagram quality loop work with the Excalidraw MCP tools?

After one create call, the Skill runs lint_drawing and score_drawing, then repair_drawing whenever the score is below 95 or any hard blocker exists. The loop repeats until score >= 95 with zero blockers, and any repair that lowers the score is rolled back to the last saved version.

When should I not use the diagram director skill?

Skip it when the diagram type, preset, and target are already fixed and you only need to edit an existing scene, when the user explicitly invoked a specific create tool with full parameters, or when the task is pure export of an already-scored drawing.

Does the skill handle secrets like API keys in diagram prompts?

Yes. All user-provided text is scanned before the create call, and JWT secrets, API keys, database URLs, tokens, and similar values are replaced with typed placeholders like [REDACTED_API_KEY]. The export is re-scanned as a backstop, and detected values are never echoed in responses.

What are the hard blockers that prevent a diagram from being accepted?

Three hard blockers must be absent: ARROW_TEXT_INTERSECTION (arrows crossing text boxes), FRAME_TITLE_OVERLAP (content in the top 40px title band of a frame), and ITEM_OUTSIDE_FRAME (elements outside their frame bounds). Penalties like TEXT_NEAR_EDGE, HIGH_DENSITY, and SMALL_FONT are also driven toward zero.

How do library icons work in curated or required mode?

The Skill reads MCP_LIBRARY_MODE first. In curated or required mode, recognized-concept icons are auto-injected by the server, and personal templates are inserted via search_libraries, inspect_library, then add_library_items_normalized into defined slots like inside-card-left, badge, or database-symbol. Any icon that lowers the score is rejected.