diagram-import

Import architectural diagrams from Draw.io, Miro, and Mermaid into Azure DevOps work items.

47|10|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/gonzalezpazmonica/pm-workspace --skill diagram-import
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: diagram-import
Source: https://github.com/gonzalezpazmonica/pm-workspace/tree/main/.claude/skills/diagram-import
Command: npx skills add https://github.com/gonzalezpazmonica/pm-workspace --skill diagram-import

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the process of converting architectural diagrams into structured work items (Features, PBIs, Tasks) in Azure DevOps, bridging the gap between design and implementation.

Core Features & Use Cases

  • Diagram Parsing: Supports Draw.io, Miro, Mermaid, and local files.
  • Entity Recognition: Identifies services, databases, queues, and other components from visual shapes and labels.
  • Business Rule Validation: Ensures critical business logic is documented before creating work items.
  • Work Item Generation: Creates Features, PBIs, and Tasks in Azure DevOps based on parsed entities and validated rules.
  • Use Case: A system architect draws a new microservice architecture in Draw.io. This Skill imports the diagram, validates that each service has documented business rules, and then generates the necessary Features and PBIs in Azure DevOps for the development team to start working on.

Quick Start

Import the diagram from the provided URL and create the corresponding work items in Azure DevOps.

Frequently Asked Questions about diagram-import

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert Draw.io architecture diagrams into Azure DevOps work items?

To convert Draw.io architecture diagrams into Azure DevOps work items, you can import the diagram URL to automatically parse visual shapes, validate business rules, and generate structured Features, PBIs, and Tasks.

Can I generate Azure DevOps PBIs from a Mermaid diagram?

Yes, you can generate Azure DevOps PBIs from a Mermaid diagram. The parser recognizes services, databases, and queues from the diagram syntax, validates architectural completeness, and creates the corresponding work items.

What is the process for validating business rules before creating work items from architectural diagrams?

Validating business rules before creating work items involves parsing the imported diagram to ensure critical business logic is documented for each recognized entity, preventing incomplete architectural designs from being pushed to Azure DevOps.

Does the diagram import support local files as well as Miro and Draw.io?

Yes, the diagram import supports local files alongside Miro and Draw.io. It parses these various sources to identify architectural components and automatically generate structured Features and Tasks in Azure DevOps.

How do architectural diagrams get parsed into Features and Tasks for development teams?

Architectural diagrams get parsed into Features and Tasks by recognizing visual shapes and labels as entities like services and queues. After validating adherence to business rules, it generates the corresponding work items in Azure DevOps.