business-process-modeling

Generate Mermaid diagrams and optional BPMN XML for business processes.

1|Updated Nov 29, 2025
One-click install
npx skills add https://github.com/SSiertsema/claude-code-plugins --skill business-process-modeling
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: business-process-modeling
Source: https://github.com/SSiertsema/claude-code-plugins/tree/main/business-process-modeling/skills/business-process-modeling
Command: npx skills add https://github.com/SSiertsema/claude-code-plugins --skill business-process-modeling

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

BPMN modeling helps teams formalize and visualize business processes using BPMN 2.0 conventions, producing structured specs and diagrams (Mermaid flowcharts) with optional BPMN XML emission for tooling.

Core Features & Use Cases

  • BPMN-compliant vocabulary including events, activities, gateways, and flows with swim lanes for actor separation.
  • Generates Mermaid flowcharts approximating BPMN and can emit optional BPMN XML for Camunda / bpmn.io tooling.
  • Supports as-is and to-be modes with explicit separation and optional gap analysis to compare current-state vs future-state.
  • Use cases include process discovery, documentation, and communication of complex workflows across teams.

Quick Start

Provide the process name, mode (as-is / to-be / gap), and a list of actors/roles; specify the process scope (start and end) and optional exceptions, then request a BPMN diagram and optional XML output.

Frequently Asked Questions about business-process-modeling

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

FAQPage Schema
How do I generate a Mermaid diagram from a BPMN process description?

To generate a Mermaid diagram from a BPMN process, provide the process name, mode (as-is or to-be), actors, and scope. The tool outputs Mermaid flowcharts approximating BPMN conventions with swimlanes, gateways, and events.

Can I export BPMN XML for Camunda and bpmn.io tooling?

Yes, you can export optional BPMN XML for Camunda and bpmn.io tooling. The modeling process generates standard BPMN 2.0 vocabulary including events, activities, gateways, and flows, which can be emitted as valid XML output.

What is the best way to model as-is and to-be business processes?

Model as-is and to-be business processes by specifying the desired mode and defining process scope. You can separate current-state and future-state workflows, and perform optional gap analysis to compare the differences between the two scenarios.

How do I structure BPMN swimlanes for actors and roles in a workflow?

Structure BPMN swimlanes by explicitly providing a list of actors and roles as input. The workflow model uses these actors to separate activities and events across distinct swimlanes within the generated Mermaid flowchart.

Does this BPMN modeling approach handle exceptions and happy paths?

Yes, BPMN modeling handles exceptions and happy paths. It requires specifying optional exceptions alongside the process scope, ensuring proper separation of logical flows and happy paths within the generated workflow diagrams.

What inputs do I need to start business process modeling?

To start business process modeling, you need explicit inputs including the process name, modeling mode (as-is, to-be, or gap), a list of actors or roles, and a defined process scope with starting and ending points.