CtrlK
BlogDocsLog inGet started
Tessl Logo

excalidraw-studio

Generate Excalidraw diagrams from natural language descriptions. Outputs .excalidraw JSON files openable in Excalidraw. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", "generate an Excalidraw file", "draw an ER diagram", "create a sequence diagram", or "make a class diagram". Supports flowcharts, relationship diagrams, mind maps, architecture, DFD, swimlane, class, sequence, and ER diagrams. Can use icon libraries (AWS, GCP, etc.) when set up. Do NOT use for code architecture analysis (use the architecture skills), Mermaid diagram rendering (use mermaid-studio), or non-visual documentation (use docs-writer).

75

Quality

94%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

85%Weight 40%Scale 1-5

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

A strong, well-structured skill body: clear five-step workflow with validation checklist and troubleshooting feedback loops, excellent progressive disclosure with conditional pointers to real one-level-deep reference and template files. The main costs are repetition of the same JSON-shape rules across four sections and inline code examples that are not copy-paste complete relative to the skill's own required-properties checklist.

Suggestions

Consolidate the repeated JSON-shape rules: state the boundElements/containerId and startBinding/endBinding rules once in Step 4 and have the Common Mistakes, Validation Checklist, and Troubleshooting sections reference them rather than restate them.

Include one minimal complete element example (with all required base properties such as angle, strokeStyle, seed, version, index, and "files": {}) inline, or point explicitly to a canonical complete example in references/excalidraw-schema.md, so the inline snippets are copy-paste safe.

The scripts/ directory (add-arrow.py, add-icon-to-diagram.py, split-excalidraw-library.py) is only discoverable via references/icon-libraries.md; consider a one-line pointer from the main body so the scripts are not missed for non-icon use cases.

DimensionReasoningScore

Conciseness

The body is dense with earned tokens (decision tables, exact property names, coordinates, hex palette) and never explains concepts Claude already knows, but key rules are repeated four times — the `label`-shorthand / `boundElements` / `startBinding` warnings appear in Step 4, Common Mistakes, the Validation Checklist, and the Troubleshooting table. This is noticeable reinforcement redundancy that could be trimmed, matching 'efficient; minor instances of over-explanation that could be trimmed' rather than the lean 5-anchor.

4 / 5

Actionability

Guidance is mostly executable — exact JSON property names, spacing values, ID conventions, and ready-made template files — but the inline JSON snippets omit the required base properties (`angle`, `strokeStyle`, `seed`, `version`, `index`, etc.) that the skill's own checklist says are mandatory, so copying them verbatim would produce elements the skill warns will not render. 'Mostly executable guidance... with minor gaps' fits; full 5 would require copy-paste-safe examples.

4 / 5

Workflow Clarity

The UNDERSTAND → CHOOSE TYPE → EXTRACT → GENERATE → SAVE sequence is explicit with a per-step decision matrix, and it closes with a pre-delivery Validation Checklist plus a Troubleshooting table mapping failures to fixes — exactly the checklist + error-recovery feedback loop of the 5-anchor. This is generation, not a destructive/batch operation, so no validation cap applies.

5 / 5

Progressive Disclosure

SKILL.md is a true overview: detailed extraction guidance, the JSON schema, and icon-library setup are each pushed to a clearly signaled one-level-deep reference with explicit 'read X when...' conditions ('Read references/excalidraw-schema.md before generating your first diagram'), and templates live in assets/. All referenced files exist, and no reference chains more than one level deep. This matches the 5-anchor's well-signaled structure.

5 / 5

Total

18

/

20

Passed

Description

100%Weight 40%Scale 1-5

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

An exemplary description: concrete capabilities, explicit 'Use when' triggers with natural user phrasing, third-person voice, and explicit negative boundaries against neighboring skills. Every dimension sits clearly at the top anchor.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — "Generate Excalidraw diagrams from natural language descriptions", "Outputs .excalidraw JSON files openable in Excalidraw", "Can use icon libraries (AWS, GCP, etc.)" — and comprehensively enumerates nine supported diagram types (flowcharts, relationship, mind maps, architecture, DFD, swimlane, class, sequence, ER). It matches or exceeds the 5-anchor example's coverage; nothing is left to inference.

5 / 5

Completeness

It explicitly answers both questions: what ("Generate Excalidraw diagrams... Outputs .excalidraw JSON files openable in Excalidraw") and when ("Use when asked to 'create a diagram'... or 'make a class diagram'") with concrete trigger phrases, and adds scope notes (supported types, icon libraries). This mirrors the 5-anchor example's structure exactly; a score of 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Eight quoted natural trigger phrases users would actually say ("create a diagram", "make a flowchart", "visualize a process", "draw an ER diagram", "make a class diagram") plus the file extension (.excalidraw) and the "Use when asked to" framing give comprehensive coverage of natural terms including synonyms. This is at least as complete as the 5-anchor example ("PDF files, PDFs, forms, document extraction, .pdf").

5 / 5

Distinctiveness Conflict Risk

The Excalidraw format is a clear niche, and the explicit "Do NOT use for code architecture analysis (use the architecture skills), Mermaid diagram rendering (use mermaid-studio), or non-visual documentation (use docs-writer)" boundary names adjacent skills and routes away from them, minimizing conflict risk. It is more distinctive than the 5-anchor example, which lacks any negative boundary.

5 / 5

Total

20

/

20

Passed

Validation

100%

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
tech-leads-club/agent-skills
Reviewed

Table of Contents

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.