skills.rest
gozonerd
gozonerdCOMMUNITY
Explore all skills by this author →
GitHub

bpmn-ai-orchestration

Generate BPMN 2.0 XML diagrams for AI pipeline orchestration with swimlanes and gateways.

Updated Apr 11, 2026
Search Tags:#ai orchestration#xml#process modeling#bpmn#swimlane#camunda#workflow diagram
One-click install
npx skills add https://github.com/gozonerd/shadow-ai-assessment --skill bpmn-ai-orchestration-gozonerd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bpmn-ai-orchestration
Source: https://github.com/gozonerd/shadow-ai-assessment/tree/main/.claude/skills/bpmn-ai-orchestration
Command: npx skills add https://github.com/gozonerd/shadow-ai-assessment --skill bpmn-ai-orchestration-gozonerd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designing formal process diagrams for AI workflows requires both BPMN 2.0 syntax knowledge and an understanding of agentic orchestration patterns. This Skill converts plain-language descriptions of human-AI workflows into valid BPMN 2.0 XML that renders directly in standard modeling tools. ## Core Features & Use Cases - Swimlane Architecture: Maps orchestrators, AI models (Opus, Sonnet, Haiku), and human reviewers to dedicated lanes showing who does what. - Gateway and Event Modeling: Encodes QA gates, model routing decisions, parallel execution, error handling, and escalation using exclusive, parallel, and inclusive gateways plus boundary events. - Tool-Compatible Output: Produces XML importable into bpmn.io, Camunda Modeler, Flowable, Signavio, and Bizagi. - Use Case: Describe a content pipeline where Claude Sonnet drafts, a human SME reviews at a QA gate, and failures loop back for revision — receive a complete .bpmn file ready to render. ## Quick Start Ask the AI to generate a BPMN diagram for your AI pipeline, describing the actors, models, review gates, and exception paths involved.

Frequently Asked Questions about bpmn-ai-orchestration

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

FAQPage Schema
How do I create a BPMN diagram for an AI workflow?▼

Describe who does what in your pipeline — actors, models, gates, and exception paths — and the Skill maps them to swimlanes, tasks, and gateways, then outputs complete BPMN 2.0 XML. Paste the XML into bpmn.io to render it with auto-layout.

When should I use BPMN instead of Mermaid for process diagrams?▼

Use BPMN when you need formal actor assignment via swimlanes, decision gateways, or exception handling paths. Use Mermaid for simple dependency DAGs or quick in-thread sketches, since BPMN XML is verbose and requires an external renderer.

What tools can open and render BPMN 2.0 XML files?▼

BPMN 2.0 XML renders in bpmn.io (free, browser-based), Camunda Modeler (free desktop app), and Flowable. Enterprise tools like Signavio, Bizagi, and Lucidchart also support the format.

How are AI models and humans represented in BPMN swimlanes?▼

Each actor gets a lane within the process pool: the orchestrator, each AI model (such as Opus, Sonnet, or Haiku), human SMEs for review, and a human orchestrator for overrides. AI execution uses service tasks; human review uses user tasks.

How do I model QA gates and revision loops in BPMN?▼

Use an exclusive gateway after a user task for the human review, with conditional sequence flows for pass and revise outcomes. The revise flow loops back to the AI generation task, while the pass flow continues to the end event.

What are the limitations of BPMN for AI pipeline documentation?▼

BPMN is overkill for pure dependency graphs and cannot provide interactive exploration like zoom or click behaviors. It also requires an external renderer since the XML is not human-readable as a diagram on its own.

Related Skills

Explore More Software Engineering Skills→
Ameng2001Ameng2001
1

process-flow

Convert workflow descriptions into structured business process flow diagrams.

Community
Intermediate
davistroydavistroy

bpmn-xml-generator

Generate BPMN 2.0 XML files from natural language process descriptions.

Community
Intermediate
TrecekTrecek
1

arch-lens-error-resilience

Document failure detection, propagation, and recovery with mermaid diagrams.

Community
Advanced
AradotsoAradotso
3

system-design-visualizer-tool

Convert system design images into interactive React Flow visualizations via Mermaid graphs.

Official
Advanced