Skip to content

Update drawio agent skill - #38

Merged
thomast1906 merged 11 commits into
mainfrom
feature/update-drawio-skills
Jul 29, 2026
Merged

Update drawio agent skill#38
thomast1906 merged 11 commits into
mainfrom
feature/update-drawio-skills

Conversation

@thomast1906

Copy link
Copy Markdown
Owner

This pull request reorganizes and significantly expands the reference documentation for the drawio-mcp-diagramming skill. It introduces a new, detailed AWS diagram guidance file, consolidates and clarifies diagram prompt presets, and improves guidance on shape discovery and usage. The changes make it easier for users and agents to select the correct diagram conventions, input formats, and icon styles, while also providing comprehensive examples and checklists for Azure and AWS diagrams.

Documentation restructuring and expansion:

  • Added a new aws.md file with in-depth AWS diagramming guidance, including icon usage, style conventions, container structure, traffic color palette, annotation boxes, a complete topology XML example, and a checklist for AWS diagrams.
  • Moved Azure and AWS-specific icon/style guidance into their respective new files (azure.md and aws.md), and updated the main reference index to point to these resources.

Diagram prompt and input format guidance:

  • Added a comprehensive "Diagram-Type Prompt Presets" section, providing ready-to-use prompts for common diagram types (flowchart, sequence, ER, C4, network topology, swimlane), and detailed input format instructions for Mermaid, CSV, and multi-page .drawio files.
  • Updated requirements and best practices for when to use explanation boxes, color-coding, and zone separation in Azure diagrams, making these recommendations more context-sensitive.

Shape discovery and usage:

  • Clarified that all shape/style lookups should use drawio/search_shapes, and removed reliance on static catalogs for icon discovery. Guidance now emphasizes confirming styles rather than guessing, and fallback procedures are described for missing icons.

These updates improve clarity, maintainability, and usability of the diagramming skill's reference material, ensuring agents and users can generate accurate, standards-compliant diagrams for both Azure and AWS architectures.

thomast1906 and others added 11 commits July 21, 2026 20:18
All diagram quality improvements (label dedup, DMZ guidance, annotation
box conditionals) are in drawio-mcp-diagramming skill only.
azure-drawio-mcp-diagramming has no business being changed in this PR.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Remove non-existent azure-enterprise-api-platform.drawio ref from drawio-mcp-diagramming
- Change streaming.md, errors.md, redlining.md example links in skill-creator
  to plain text so validator does not treat them as real file references

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…ples

Pattern 1 and Pattern 3 examples referenced streaming.md, errors.md and
redlining.md which do not exist. Replaced with prose descriptions of the
pattern instead.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Required for reliable skill invocation.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@thomast1906
thomast1906 merged commit 9a4eb43 into main Jul 29, 2026
3 checks passed
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