excalidash-design-polisher

Polishes existing Excalidraw drawings to a visual quality score of 95 or higher without changing semantics.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Generated or imported Excalidraw diagrams often ship with overlapping labels, arrows crossing text, ragged spacing, and clipped viewport content. This Skill runs a mandatory layout-and-cleanup pass that raises a drawing's quality score to at least 95 before it is saved or shared, without altering its meaning. ## Core Features & Use Cases - Score-gated polishing: Baselines the drawing with score_drawing, runs auto_polish_drawing, then loops lint, repair, and re-score until the score reaches 95 or no further gain is possible. - Semantic preservation: Fixes overlaps, arrow-over-text intersections, viewport overflow, and spacing while keeping node counts, edges, and labels unchanged, with rollback if a pass lowers the score. - Secret redaction: Scans all text elements before saving and replaces JWTs, API keys, database URLs, and tokens with [REDACTED_*] placeholders. - Use Case: After generating an architecture diagram from a prompt, run this Skill to reroute two arrows crossing labels, pull a clipped node back inside the viewport, and save a versioned 96-score drawing with an exportable PNG. ## Quick Start Ask the AI to polish the current Excalidraw drawing and bring its score above 95 without moving any pinned elements before saving and exporting it.

Frequently Asked Questions about excalidash-design-polisher

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

FAQPage Schema
How do I polish an Excalidraw diagram to a higher quality score?

Run the polish workflow: baseline with score_drawing, call auto_polish_drawing with preserveSemantics enabled, then loop lint_drawing, repair_drawing, and score_drawing until the score reaches 95. Save only after hardBlockers is empty.

How do I fix arrows crossing text labels in Excalidraw?

Use auto_polish_drawing, which returns a repairPlan identifying arrow-over-text defects with reroute actions. Apply residual fixes via repair_drawing, then re-score to confirm arrow-text intersections reach zero.

Can I polish a diagram without changing its content or structure?

Yes. The polish pass is pure layout: it never adds, deletes, merges, or relabels nodes or edges. Pass preserveSemantics: true and verify node and edge counts match the baseline after the pass.

What happens if a polish pass lowers the drawing score?

The pass is rejected. Restore the pre-pass elements captured from the baseline snapshot and re-run auto_polish_drawing with aggressiveness set to conservative, then re-score before saving.

When should I not run the design polisher on a drawing?

Skip it when creating a brand-new diagram, when the user wants semantic edits like adding nodes, or when the drawing already scores 95 or higher. Also skip if the user explicitly requested a rough draft below threshold.

Does the polisher handle secrets leaked into diagram text?

Yes. Before saving, every text element is scanned for JWTs, API keys, database URLs, tokens, and webhook URLs, and matches are replaced with [REDACTED_*] placeholders without affecting layout scoring.