Agent skill

bpmn-generator

Generate and validate BPMN 2.0 diagrams from process descriptions

Stars 514
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/a5c-ai/babysitter/tree/main/library/specializations/domains/business/business-analysis/skills/bpmn-generator

Metadata

Additional technical details for this skill

id
SK-002
domain
business
category
Process Modeling
specialization
business-analysis

SKILL.md

BPMN Diagram Generator

Overview

The BPMN Diagram Generator skill provides specialized capabilities for creating, validating, and exporting BPMN 2.0 (Business Process Model and Notation) compliant process diagrams. This skill enables transformation of natural language process descriptions into standardized process models that can be used across various process modeling tools.

Capabilities

BPMN 2.0 Generation

  • Generate BPMN 2.0 compliant XML from natural language process descriptions
  • Create properly structured process diagrams with correct notation
  • Support all BPMN 2.0 element types (activities, events, gateways, flows)
  • Generate collaboration diagrams with multiple pools and lanes

Notation Validation

  • Validate BPMN notation correctness against specification
  • Check for proper use of start/end events
  • Verify gateway logic and flow completeness
  • Identify unreachable activities or incomplete paths

Swimlane Layout

  • Create swimlane layouts automatically based on participant roles
  • Organize activities by responsible parties
  • Handle cross-lane message flows
  • Optimize layout for readability

Gap Identification

  • Identify missing gateways in decision points
  • Flag missing events (start, end, intermediate)
  • Detect incomplete or disconnected flows
  • Highlight activities without clear inputs/outputs

AS-IS to TO-BE Comparison

  • Generate side-by-side comparison views
  • Highlight differences between current and future states
  • Track process improvement changes
  • Calculate process metric differences

Multi-Format Export

  • Export to SVG for web display
  • Export to PNG for documentation
  • Export to BPMN XML for tool import
  • Generate Markdown representations for documentation

Tool Integration

  • Integrate with Camunda process engine format
  • Support Bizagi file format
  • Compatible with Signavio exports
  • Support for draw.io BPMN diagrams

Usage

Generate BPMN from Description

Generate a BPMN 2.0 diagram for the following process:
[Process description in natural language]

Include swimlanes for each role mentioned and proper gateway notation.

Validate Existing BPMN

Validate this BPMN diagram for compliance:
[BPMN XML content]

Check for notation correctness and process completeness.

AS-IS to TO-BE Comparison

Compare the AS-IS and TO-BE processes:

AS-IS: [Current process description]
TO-BE: [Future process description]

Generate comparison view highlighting improvements.

Process Integration

This skill integrates with the following business analysis processes:

  • bpmn-process-modeling.js - Core BPMN modeling activities
  • sipoc-process-definition.js - Process boundary definition
  • value-stream-mapping.js - Process flow visualization
  • process-gap-analysis.js - Current vs future state comparison

Dependencies

  • BPMN 2.0 specification library
  • Diagram rendering capabilities
  • XML generation and validation
  • Layout algorithms for swimlane optimization

BPMN 2.0 Elements Reference

Flow Objects

  • Events: Start, Intermediate, End (Message, Timer, Error, Signal, etc.)
  • Activities: Task, Sub-Process, Call Activity
  • Gateways: Exclusive, Inclusive, Parallel, Event-Based, Complex

Connecting Objects

  • Sequence Flows: Connect flow objects within a pool
  • Message Flows: Connect objects between pools
  • Associations: Connect artifacts to flow objects

Swimlanes

  • Pools: Represent participants/organizations
  • Lanes: Subdivisions within pools for roles/departments

Artifacts

  • Data Objects: Information flowing through process
  • Groups: Visual grouping of elements
  • Annotations: Additional explanatory text

Expand your agent's capabilities with these related and highly-rated skills.

a5c-ai/babysitter

gsd-tools

Central utility skill for GSD operations. Provides config parsing, slug generation, timestamps, path operations, and orchestrates calls to other specialized skills. Acts as the unified entry point that the original gsd-tools.cjs provided via its lib/ modules (commands, config, core, init).

514 31
Explore
a5c-ai/babysitter

model-profile-resolution

Resolve model profile (quality/balanced/budget) at orchestration start and map agents to specific models. Enables cost/quality tradeoffs by selecting appropriate AI models for each agent role.

514 31
Explore
a5c-ai/babysitter

verification-suite

Plan structure validation, phase completeness checks, reference integrity verification, and artifact existence confirmation. Provides the structured verification layer ensuring GSD artifacts are well-formed and complete.

514 31
Explore
a5c-ai/babysitter

state-management

STATE.md reading, writing, and field-level updates. Provides cross-session state persistence via .planning/STATE.md with structured fields for current task, completed phases, blockers, decisions, and quick tasks.

514 31
Explore
a5c-ai/babysitter

git-integration

Git commit patterns, formats, and conventions for GSD methodology. Provides atomic commits per task, structured commit messages, planning file commits, branch management, and milestone tag operations.

514 31
Explore
a5c-ai/babysitter

frontmatter-parsing

YAML frontmatter parsing and manipulation for .planning/ documents. Provides read, write, update, query, and validation operations on frontmatter blocks in GSD markdown artifacts.

514 31
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results