diagram-maker

Create SVG/HTML or Excalidraw diagrams for concepts, architecture, flows, and whiteboards.

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/diagram-maker/SKILL.md

Quality

Content

78%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.

The body is lean, well-structured, and actionable with concrete rules and a clear sequenced workflow; its main gaps are the hedged validation step and the absence of inline executable code snippets, both deferred to references.

Dimension	Reasoning	Score
Conciseness	Terse bullets assume Claude's competence (no explanations of SVG/Excalidraw) and most tokens earn their place; mild redundancy between the 'output modes' list and 'Routing' plus the non-instructional 'PilotDeck Migration Note' keep it just below a 5.	4 / 5
Actionability	Gives highly specific rules (fill="none", marker arrows, 24px padding, 120x60 min shape, roughness 1, fontFamily 1, required JSON fields), but actual executable snippets are deferred to the references rather than inline, so it is mostly executable with a minor gap.	4 / 5
Workflow Clarity	A clear 5-step sequence ends with a verify step ('Verify syntax by opening/parsing when feasible'), but validation is hedged and lacks a fix-and-retry feedback loop, matching 'clear sequence with most checkpoints; minor validation gaps'.	4 / 5
Progressive Disclosure	SKILL.md is an overview that clearly signals one-level-deep references to references/svg-template.md and references/excalidraw-patterns.md (both present), with templates/patterns appropriately split out and easy to navigate.	5 / 5
	Total	17 / 20 Passed

Description

61%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.

The description is concise and third-person with a clear niche and decent natural trigger terms, but it omits an explicit 'Use when...' clause, which caps completeness and limits trigger guidance.

Suggestions

Add an explicit 'Use when...' clause naming concrete triggers, e.g. 'Use when the user asks for a diagram, flowchart, architecture sketch, or whiteboard.'

Broaden trigger-term coverage with synonyms like flowchart, schematic, and sequence diagram that users commonly say.

List more concrete actions beyond 'Create' (e.g. render, lay out, export) to lift specificity from 3 toward 4-5.

Dimension	Reasoning	Score
Specificity	Names one concrete action ('Create ... diagrams') across two output formats and several domains (concepts, architecture, flows, whiteboards), but does not list multiple distinct actions, so it matches 'names domain and 1-2 concrete actions' rather than the 'several specific actions' of a 4.	3 / 5
Completeness	Has a clear 'what' (create diagrams for the listed domains) but no explicit 'Use when...' trigger clause, so per the cap on missing trigger guidance it cannot exceed 3; the 'when' is only weakly implied.	3 / 5
Trigger Term Quality	Includes natural terms users say ('diagrams', 'architecture', 'flows', 'whiteboards') plus format names ('SVG/HTML', 'Excalidraw'); a few synonyms (chart, flowchart, schematic) are missing, so it is good but not comprehensive.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche (diagrams via SVG/HTML or Excalidraw) with format-specific triggers and minor overlap risk; not a 5 because the concept/architecture/flow domain is fairly broad and lacks ultra-distinct trigger phrases.	4 / 5
	Total	14 / 20 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: OpenBMB/PilotDeck
Path: skills/diagram-maker/SKILL.md
Commit: 9a33f4d

Reviewed: 2 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.