Agent skill
bpmn-generator
Generate and validate BPMN 2.0 diagrams from process descriptions
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
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
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).
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.
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.
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.
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.
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.
Didn't find tool you were looking for?