feat(skills): add excalidraw-diagram-generator skill and docs update#624
feat(skills): add excalidraw-diagram-generator skill and docs update#624jun-shiromizu wants to merge 10 commits intogithub:mainfrom
Conversation
There was a problem hiding this comment.
Pull request overview
This pull request adds a new skill called excalidraw-diagram-generator that enables automated creation of Excalidraw diagrams from natural language descriptions. The skill supports multiple diagram types including flowcharts, relationship diagrams, mind maps, architecture diagrams, data flow diagrams, swimlane diagrams, class diagrams, sequence diagrams, and ER diagrams.
Changes:
- Introduces comprehensive diagram generation capability with templates for 8 diagram types
- Includes Python utility scripts for icon library management and diagram manipulation
- Adds detailed reference documentation for Excalidraw JSON schema and element types
Reviewed changes
Copilot reviewed 16 out of 17 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| skills/excalidraw-diagram-generator/SKILL.md | Main skill documentation defining capabilities, workflow, and usage patterns |
| skills/excalidraw-diagram-generator/templates/*.excalidraw | Eight diagram templates providing base structures for different diagram types |
| skills/excalidraw-diagram-generator/scripts/*.py | Python utilities for icon library splitting and diagram manipulation |
| skills/excalidraw-diagram-generator/scripts/README.md | Documentation for the Python utility scripts |
| skills/excalidraw-diagram-generator/references/*.md | Reference documentation for Excalidraw schema and element types |
| docs/README.skills.md | Updated skill registry with the new excalidraw-diagram-generator entry |
- Improved error messages within the `find_library_file` function to include directory names - Organized comments within the `sanitize_filename` function - Improved error messages within the `split_library` function to include directory names
aaronpowell
left a comment
aaronpowell
left a comment
There was a problem hiding this comment.
Would it be worth including a .gitignore file in the scripts folder to avoid the skill generating python artifacts that are inadvertently added to a repo when the skill is used?
There was a problem hiding this comment.
Remove this file, we don't want empty folders.
Deleted .gitkeep in skills/excalidraw-diagram-generator/libraries/.
- Improved error message clarity by including directory path - Regenerated READMEs via npm start to fix CI validation
Pull Request Checklist
npm startand verified thatREADME.mdis up to date.Description
Summary
Add a new skill,
excalidraw-diagram-generator, to generate Excalidraw.excalidrawJSON diagrams from natural language requests. It supports multiple diagram types (flowcharts, relationship diagrams, mind maps, architecture, DFD, swimlane, class, sequence, ER) and provides step-by-step guidance and templates. Includes guidance for optional icon library usage via bundled scripts.Why / Use cases
.excalidrawfiles that open in Excalidraw or the VS Code extensionHow to use (quick start)
.excalidrawJSON file and open it in Excalidraw (web or VS Code extension).Validation / Tests
npm run skill:validatenpm run buildbash scripts/fix-line-endings.shDistinct from existing skills
Type of Contribution
Additional Notes
By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.