excalidash-library-curator

Enriches Excalidraw diagrams by inserting personal library templates with score-guarded rollback.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Diagrams generated from primitives often look flat and inconsistent with a user's established visual style, and manually reusing saved template blocks risks breaking layout, overlapping labels, or lowering diagram quality scores. ## Core Features & Use Cases - Personal Template Reuse: Searches and inspects the user's own imported Excalidraw library templates, then inserts them normalized to the drawing's grid, opacity, and font via add_library_items_normalized. - Score-Guarded Insertion: Re-scores the drawing after every insertion and automatically reverts any template that lowers the score, introduces arrow-over-text intersections, or causes label overlap. - Quality Gate & Audit Trail: Runs a lint-repair-polish loop until the drawing scores 95 or higher, redacts secrets from text elements, and records a used/rejected ledger in the saved version note. - Use Case: After generating a microservices architecture diagram, ask the agent to apply your saved "service card" and "auth block" templates so the diagram matches your other documents, with automatic rollback if any insertion degrades the layout. ## Quick Start Ask the agent to insert your saved template into an existing diagram, for example: "Reuse my standard service card template for these three nodes in drawing drw_a17c and keep the score at 95 or above."

Frequently Asked Questions about excalidash-library-curator

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

FAQPage Schema
How do I reuse my saved Excalidraw templates in an existing diagram?

Provide the drawing ID and the template name, and the skill searches your personal library with search_libraries, inspects candidates, then inserts the chosen template via add_library_items_normalized. Each insertion is re-scored and reverted if it lowers the drawing's score.

How does the score guard work when inserting library items?

The skill records a baseline score_drawing result before inserting, then re-scores after each insertion. Any item that lowers the measured score or creates arrow-over-text or label-overlap blockers is reverted from the snapshot and recorded as rejected with a reason.

Can I pull icons from a public Excalidraw library catalog?

No, there is no curated or public catalog and no network access. Recognized-concept icons are auto-injected by the server on create, and search_libraries only returns templates from your own imported personal library.

When should I not use the library curator skill?

Do not use it when MCP_LIBRARY_MODE is off, when no diagram exists yet, or when you have no personal template for the concept. In those cases draw primitives in the active preset or rely on the server's auto-injected concept icons.

What happens if an inserted template causes overlaps or density issues?

The insertion is reverted from the pre-curation snapshot and the skill falls back to a simpler template or a preset primitive. A lint_drawing and repair_drawing loop then runs until the score reaches 95 with empty hardBlockers.

Does the skill handle secrets in diagram text before saving?

Yes, every text element is scanned before the final save and any JWT, API key, database URL, token, or similar credential is replaced with a typed placeholder such as [REDACTED_API_KEY] or [REDACTED_DATABASE_URL].