🤖 AI-Maintained — This repository is maintained by AI agents. Human commits (perhaps) zero. Liability (certainly) none. Fun (definitely) infinite.

BPMN Skill

Create BPMN 2.0 compliant business process diagrams using Draw.io.

Overview

This skill enables AI assistants to generate professional business process diagrams following the BPMN 2.0 (Business Process Model and Notation) standard. All diagrams are produced in Draw.io XML format for easy editing and collaboration.

Features

• Full BPMN 2.0 Support: Events, Activities, Gateways, Swimlanes, and Artifacts
• Event Types: Start, Intermediate, End events with 12 trigger types
• Activity Types: User Tasks, Service Tasks, Script Tasks, Subprocesses, Transactions
• Gateway Types: Exclusive (XOR), Parallel (AND), Inclusive (OR), Event-based
• Swimlanes: Pools and Lanes for cross-departmental process modeling
• Connections: Sequence flows, Message flows, Associations
• Boundary Events: Timer, Error, Message, Compensation events

Installation

Using OpenSkills CLI

npx openskills install deeparchi/bpmn-skill

Manual Installation

Clone or download this repository to your skills directory:

# For Claude Desktop
git clone https://github.com/deeparchi/bpmn-skill.git ~/.claude/skills/bpmn

# For Cursor
git clone https://github.com/deeparchi/bpmn-skill.git ~/.cursor/skills/bpmn

Usage

Simply ask the AI to create a business process diagram:

• "创建一个订单处理流程图"
• "Create a leave approval workflow diagram"
• "帮我画一个客户服务流程的BPMN图"
• "Design a multi-department order fulfillment process"

File Structure

bpmn/
├── SKILL.md                    # Main skill instructions
├── README.md                   # This file
├── EXAMPLES.md                 # Complete BPMN diagram examples
├── package.json                # Package configuration
├── LICENSE                     # MIT License
└── references/
    ├── bpmn-elements.md        # BPMN 2.0 elements reference
    ├── bpmn-events.md          # Event types detailed guide
    └── bpmn-drawio-styles.md   # Draw.io styling reference

Examples

The skill includes 5 complete examples:

1. Simple Approval Process - Basic conditional branching
2. Order Processing Flow - Cross-department swimlanes
3. Parallel Review Process - Parallel gateway usage
4. Timeout Handling - Boundary event application
5. Cross-Organization Message Flow - Multi-pool message interaction

Color Scheme

Element	Fill Color	Stroke Color
Start Event	#d5e8d4	#82b366
Intermediate Event	#fff2cc	#d6b656
End Event	#f8cecc	#b85450
Task/Activity	#dae8fc	#6c8ebf
Gateway	#fff2cc	#d6b656
Subprocess	#e1d5e7	#9673a6
Pool/Lane	#f5f5f5	#666666

Requirements

• Draw.io desktop app or web version (https://app.diagrams.net)
• AI assistant with skill support (Claude, Cursor, etc.)

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

Related Skills

• DeepArchi - ArchiMate enterprise architecture diagrams
• Draw.io - General diagram creation skill

Author

DeepArchi - https://deeparchi.com