orgchart-import

Imports org charts from Mermaid, Draw.io XML, and Miro into a structured teams directory.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Manually creating and maintaining team structures in files is time-consuming and error-prone. This Skill automates the import of organizational charts from visual diagrams into a structured file format, ensuring consistency and saving significant administrative effort.

Core Features & Use Cases

  • Multi-format Import: Supports importing from Mermaid, Draw.io XML, and Miro boards.
  • Automated Structure Generation: Creates and updates department and team files (dept.md, team.md, member profiles) based on the imported diagram.
  • Conflict Resolution: Offers create, merge (default), and overwrite modes to safely manage existing data.
  • Use Case: A PM has a Mermaid org chart diagram. They can use this Skill to instantly generate the corresponding teams/ directory structure, including department and team definitions, and member profiles, ensuring the codebase reflects the current organizational hierarchy.

Quick Start

Import the organizational chart from the file 'orgchart.mermaid' into the teams directory.

Frequently Asked Questions about orgchart-import

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

FAQPage Schema
How do I import an org chart from Mermaid into a structured teams directory?

You can import an org chart from Mermaid by having the Skill parse the diagram data, normalize it into an intermediate JSON model, and automatically generate or update department, team, and member profile files in the `teams/` directory.

What diagram formats can I use to automatically generate team hierarchy files?

Supported diagram formats for generating team hierarchy files include Mermaid, Draw.io XML, and Miro board data, which are normalized into a structured file system representation of your teams and departments.

Does the org chart import process work with existing team files or will it overwrite my data?

The import process works safely with existing team files by offering configurable conflict resolution modes, including `merge` (default) to update existing structures, `create` to add new entries, or `overwrite` to replace data.

How do I convert a Draw.io XML diagram into department and team markdown files?

To convert a Draw.io XML diagram into markdown files, the Skill parses the XML, validates data integrity, and generates corresponding `dept.md`, `team.md`, and member profile files in your `teams/` directory.

What is the best way to automate organizational structure updates from visual diagrams?

Automating organizational structure updates is best handled by importing visual diagrams through a normalization process that validates data integrity and generates structured team files, ensuring consistency and saving administrative effort.

What happens if there are conflicts when importing a Miro board org chart into existing team structures?

If conflicts occur when importing a Miro board org chart, the Skill offers configurable resolution modes like `merge` or `overwrite` to safely manage existing data, ensuring accurate and safe updates to your organizational structure.