Skip to content

Addding draw-io-diagram-generator Agent Skill and Instructions#1178

Closed
SriSatyaLokesh wants to merge 8 commits intogithub:stagedfrom
SriSatyaLokesh:draw-io-diagram-generator-skill
Closed

Addding draw-io-diagram-generator Agent Skill and Instructions#1178
SriSatyaLokesh wants to merge 8 commits intogithub:stagedfrom
SriSatyaLokesh:draw-io-diagram-generator-skill

Conversation

@SriSatyaLokesh
Copy link
Copy Markdown
Contributor

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • I have read and followed the Guidance for submissions involving paid services.
  • My contribution adds a new instruction, prompt, agent, skill, or workflow file in the correct directory.
  • The file follows the required naming convention.
  • The content is clearly structured and follows the example format.
  • I have tested my instructions, prompt, agent, skill, or workflow with GitHub Copilot.
  • I have run npm start and verified that README.md is up to date.
  • I am targeting the staged branch for this pull request.

Description

This PR adds two new contributions for Draw.io (diagrams.net) support in GitHub Copilot to the awesome-copilot repository:

  1. skills/draw-io-diagram-generator/ — The skill enables users to generate Draw.io or diragrams.net diagrams from natural language descriptions, supporting various diagram types such as flowcharts, sequence diragrams, UML diagrams, architecture diagrams, and more directly from vscode or in copilot CLI. The skill includes a fully documented SKILL.md, bundled XML templates for common diagram types, and a Python validation script to verify generated .drawio files.

  2. instructions/draw-io.instructions.md — A new instruction file that automatically applies Draw.io diagram standards whenever Copilot works with .drawio, .drawio.svg, or .drawio.png files. It enforces a required workflow (identify → select template → plan → generate → validate), references the skill for full XML recipes, and ensures consistent, valid mxGraph XML output across all Draw.io files in a project.

Together, these two files provide end-to-end Draw.io support - the instruction file ensures Copilot follows best practices when working on existing diagram files, while the skill handles generation from scratch.


Type of Contribution

  • New instruction file.
  • New prompt file.
  • New agent file.
  • New plugin.
  • New skill file.
  • New agentic workflow.
  • Update to existing instruction, prompt, agent, plugin, skill, or workflow.
  • Other (please specify):

Additional Notes

All skills validated successfully. No breaking changes.

Draw.io (diagrams.net) is one of the most widely adopted diagramming tools in software engineering and architecture workflows, with deep integrations in VS Code, Confluence, GitHub, and more. Despite this, there was no existing skill in the awesome-copilot repository to help users generate Draw.io diagrams using natural language - a common, repetitive task. Adding draw-io-diagram-generator skill fills this gap by letting Copilot users describe a system, workflow, or architecture in plain natural language and get a ready-to-open .drawio file in return, significantly reducing the time spent on manual diagramming. This makes the skill a high-value, practical addition to the collection for developers, architects, and technical writers alike.


By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant