Generate hand-drawn style diagrams, flowcharts, and architecture diagrams as PNG images from Excalidraw JSON
84
Quality
77%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./public/skills/a-anand-91119/excalidraw/SKILL.mdQuality
Discovery
67%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 excels at specificity and distinctiveness by clearly identifying the Excalidraw-based hand-drawn diagram generation capability. However, it lacks explicit trigger guidance ('Use when...') which limits Claude's ability to know when to select this skill, and could benefit from additional natural trigger terms users might use.
Suggestions
Add a 'Use when...' clause with trigger scenarios like 'Use when the user asks for hand-drawn diagrams, whiteboard-style visuals, or mentions Excalidraw'
Include additional natural trigger terms users might say: 'sketch', 'whiteboard', 'hand-drawn', '.excalidraw', 'rough diagram'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'hand-drawn style diagrams, flowcharts, and architecture diagrams' with specific output format 'PNG images' and input format 'Excalidraw JSON'. | 3 / 3 |
Completeness | Clearly answers 'what' (generate diagrams as PNG from Excalidraw JSON) but lacks an explicit 'Use when...' clause to guide Claude on when to select this skill. | 2 / 3 |
Trigger Term Quality | Includes good terms like 'diagrams', 'flowcharts', 'architecture diagrams', 'Excalidraw', and 'PNG', but missing common variations users might say like 'sketch', 'whiteboard style', 'visual', or file extensions like '.excalidraw'. | 2 / 3 |
Distinctiveness Conflict Risk | Very distinct niche combining 'Excalidraw', 'hand-drawn style', and specific diagram types - unlikely to conflict with generic diagramming or image generation skills. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
87%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted skill with excellent conciseness and actionability. The JSON templates and element reference tables are immediately usable. The main weakness is the workflow section, which lacks validation steps and error handling guidance for a multi-step process involving file generation and external script execution.
Suggestions
Add a validation step after rendering (e.g., 'Verify PNG was created: check file exists and size > 0')
Include error handling guidance: what to do if render.js fails, common JSON syntax errors to watch for
Consider adding a 'Troubleshooting' section for common issues like missing dependencies or malformed JSON
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, using tables and code blocks to convey information densely. No unnecessary explanations of concepts Claude would already know—it jumps straight to actionable specifications. | 3 / 3 |
Actionability | Provides fully executable JSON examples, complete templates, and copy-paste ready code. The flowchart template is a complete working example that can be used immediately. | 3 / 3 |
Workflow Clarity | The 4-step workflow is clearly listed, but lacks validation checkpoints. There's no guidance on what to do if rendering fails, no verification step to check the output PNG, and no error recovery instructions for a process that could fail at multiple points. | 2 / 3 |
Progressive Disclosure | Content is well-organized with clear sections (Workflow, Quick Reference, Element Types, Templates, Guidelines, Tips). For a skill of this size, the single-file structure with logical sections is appropriate and easy to navigate. | 3 / 3 |
Total | 11 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
45f9fac
Table of Contents
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.