excalidraw

Create Excalidraw diagrams programmatically. Use when the user wants architecture diagrams, flowcharts, or any visual diagram with a hand-drawn aesthetic, where editable output and drag-and-drop editing add value over Mermaid's text-only approach.

Quality

—

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable, executable skill body with clear quick-start guidance and real bundle references. Its main weaknesses are verbosity from inlining the entire API reference and the absence of explicit validation checkpoints in the generation/export workflow despite a validator bundle being available.

Suggestions

Move the full API reference (Diagram/Flowchart/ArchitectureDiagram method tables and the color/styling tables) into a separate references/ file and keep only a concise Quick Start plus class list in SKILL.md, with clearly signaled links.

Add an explicit validation step to the generation workflow (e.g., run the existing line_routing_validator.py on the output, or confirm the .excalidraw opens/renders) before declaring the diagram complete, turning it into a validate-then-fix feedback loop.

Trim the three full examples down to one compact canonical example inline, and reference the others as bundle examples, to reduce token cost while preserving actionability.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient with no padded concept explanation, but ~400 lines of inline full API reference, color tables, and three near-complete examples could be tightened or externalized, matching the score-2 'mostly efficient but could be tightened' anchor rather than the lean score-3 anchor.	2 / 3
Actionability	Provides fully executable, copy-paste Python with concrete class/method signatures, working examples, and exact export commands, matching the score-3 anchor for fully executable guidance.	3 / 3
Workflow Clarity	Quick Start gives a clear recommended method and the viewing/export steps are sequenced, but the generation/export workflow lacks explicit validation checkpoints despite a line_routing_validator.py bundle existing; matching the score-2 anchor of sequence present but checkpoints missing.	2 / 3
Progressive Disclosure	Quick Start overview and organized sections exist with real one-level-deep script bundle references (excalidraw_generator.py, export_playwright.js), but the full API reference is kept inline rather than split to a separate reference file, matching the score-2 anchor of API reference that could be in a separate file.	2 / 3
	Total	9 / 12 Passed

Description

90%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A well-formed description that clearly states the skill's purpose and provides explicit, natural-sounding trigger guidance with a distinct niche. Its only weakness is naming a single broad action rather than enumerating several concrete capabilities.

Suggestions

Optionally enumerate a couple more concrete capabilities (e.g., "Generate flowcharts, architecture diagrams, and sequence diagrams") to lift specificity from a single broad action to multiple concrete actions.

Dimension	Reasoning	Score
Specificity	Names the concrete action "Create Excalidraw diagrams programmatically" and the output format, but lists a single primary action rather than multiple distinct concrete actions (e.g. extract/fill/merge), matching the score-2 anchor.	2 / 3
Completeness	Explicitly states what it does ("Create Excalidraw diagrams programmatically") and includes an explicit "Use when..." trigger clause, clearly answering both what and when.	3 / 3
Trigger Term Quality	Natural terms users would say are well covered — "architecture diagrams, flowcharts, or any visual diagram with a hand-drawn aesthetic" — matching the good-coverage anchor.	3 / 3
Distinctiveness Conflict Risk	The Excalidraw-vs-Mermaid contrast, hand-drawn aesthetic, and editable-output framing carve a clear niche unlikely to trigger the wrong skill; uses third-person voice with no penalty.	3 / 3
	Total	11 / 12 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: tslateman/duet
Commit: 436824a

Reviewed: 5 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.