bpmn-generator

Convert natural-language process descriptions into BPMN 2.0 XML and SVG diagrams.

28|5|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/Stieges/bpmn-generator --skill bpmn-generator-stieges
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bpmn-generator
Source: https://github.com/Stieges/bpmn-generator/tree/main
Command: npx skills add https://github.com/Stieges/bpmn-generator --skill bpmn-generator-stieges

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires elkjs, bpmn-moddle, @modelcontextprotocol/sdk, ajv, ajv-formats, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill turns business process descriptions into BPMN 2.0 diagrams without forcing you to hand-build XML, manage layout coordinates, or juggle separate validation and rendering tools. It helps teams create, refine, and share process models that are structurally sound, visually readable, and ready for BPMN-compatible editors.

Core Features & Use Cases

  • Text to BPMN: Convert natural-language process descriptions into Logic-Core JSON, then into compliant BPMN XML and SVG previews.
  • Multi-pool and lane modeling: Build collaborations with multiple participants, swimlanes, and message flows for cross-team or cross-organization processes.
  • Validation and round-tripping: Check structural correctness, deadlocks, gateway rules, and schema compliance, or import existing BPMN to edit and regenerate it.
  • Automation-friendly workflows: Use the Skill through a local pipeline, an MCP server, or an HTTP API for repeatable generation in developer and agentic workflows.
  • Use case: A product analyst describes an approval workflow in plain language, and the Skill returns a polished BPMN diagram with validation feedback and exportable XML.

Quick Start

Ask the BPMN Generator to convert your process description or Logic-Core JSON into a BPMN 2.0 XML file and SVG preview.

Frequently Asked Questions about bpmn-generator

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

FAQPage Schema
How do I generate BPMN diagrams from text descriptions?

You can generate BPMN diagrams from text by converting natural-language process descriptions into Logic-Core JSON, which is then transformed into OMG-compliant BPMN 2.0 XML and SVG previews. This avoids manual XML editing and layout coordinate management.

Can I create multi-pool collaborations and swimlanes in BPMN XML?

Yes, you can model multi-pool collaborations and swimlanes in BPMN XML. The generation process supports multiple participants, swimlanes, and message flows for cross-team or cross-organization processes.

What is Logic-Core JSON used for in BPMN diagram generation?

Logic-Core JSON serves as the intermediate data structure that translates natural-language process descriptions into BPMN 2.0 XML and SVG. It enables deterministic layout, schema validation, and BPMN serialization for your diagrams.

Does the BPMN generation process validate deadlocks and gateway rules?

Yes, the BPMN generation process validates deadlocks, gateway rules, and schema compliance. It checks structural correctness to ensure your workflow models are sound before exporting the BPMN XML and SVG diagrams.

Can I import and edit existing BPMN inputs for round-tripping?

Yes, you can import existing BPMN inputs to edit and regenerate them. The round-tripping capability allows you to refine process models while maintaining OMG-compliant BPMN 2.0 XML standards and visual readability.

What is the best way to automate BPMN diagram generation in developer workflows?

The best way to automate BPMN diagram generation is through a local pipeline, an MCP server, or an HTTP API. This enables repeatable generation of BPMN XML and SVG previews within developer and agentic workflows.