bpmn-diagrams

Convert Mermaid flowchart diagrams into BPMN 2.0 files with BPMNDI.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/apadern/.github_tailormade --skill bpmn-diagrams
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bpmn-diagrams
Source: https://github.com/apadern/.github_tailormade/tree/main/skills/bpmn-diagrams
Command: npx skills add https://github.com/apadern/.github_tailormade --skill bpmn-diagrams

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Mermaid diagrams for process planning are easy to author, but turning them into formal BPMN 2.0 + BPMNDI diagrams compatible with Camunda Modeler is tedious and error-prone.

Core Features & Use Cases

  • Automated BPMN generation: Produces one BPMN file per Mermaid process, with lanes inferred from actor/role mappings.
  • Standards-compliant output: Ensures BPMN 2.0 + BPMNDI structure suitable for Camunda, including subProcess definitions and collapsed diagrams in the main diagram.
  • Use Case: When you have Mermaid diagrams in analisis/07_diagramas_procesos.md, run this skill to generate analisis/bpmn/01_<process_slug>.bpmn for each process.

Quick Start

Convert Mermaid flows from analisis/07_diagramas_procesos.md into BPMN files placed under analisis/bpmn/.

Frequently Asked Questions about bpmn-diagrams

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

FAQPage Schema
How do I convert Mermaid flowcharts into BPMN 2.0 files for Camunda Modeler?

To convert Mermaid flowcharts into BPMN 2.0 files, this skill parses process diagrams and outputs standards-compliant BPMN with BPMNDI, automatically inferring lanes from actor mappings to ensure compatibility with Camunda Modeler.

What is the best way to generate BPMN diagrams from existing Mermaid process flows?

Generating BPMN diagrams from Mermaid process flows is best handled by automating the conversion using a drill-down subProcess approach, which creates a primary diagram and a secondary diagram for internal details.

Do I need to manually define swimlanes when generating BPMN from Mermaid?

You do not need to manually define swimlanes when generating BPMN from Mermaid. The skill automatically infers lanes by cross-referencing the process flows with your defined actors and roles.

How does BPMNDI structure validation work for converted Mermaid diagrams?

BPMNDI structure validation for converted Mermaid diagrams works by enforcing correct BPMN 2.0 structure during generation and running validation steps to ensure the output is error-free before deployment.

Can I use Camunda Modeler with BPMN files generated from Mermaid diagrams?

You can use Camunda Modeler with these BPMN files because the output strictly enforces BPMN 2.0 + BPMNDI standards, including collapsed subProcess definitions suitable for direct import.

Why does my BPMN output fail to load in Camunda after converting from Mermaid?

BPMN output may fail to load in Camunda if the Mermaid diagram lacks proper structure. The skill includes validation steps to enforce BPMN 2.0 correctness and prevent such import errors.