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.