markdown-viewer/skills

bpmn

Create business process diagrams using PlantUML syntax with BPMN, EIP, and Lean Mapping stencil icons. Best for workflow automation, approval chains, message-based integration patterns, and value stream mapping.

All-time #4005 Trending #7726 Hot #755 First seen Apr 11, 2026
8-week activity · all time api

Installation

$ npx skills add markdown-viewer/skills --skill bpmn

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from markdown-viewer/skills · top by installs.

npx skills add markdown-viewer/skills

Browse all from markdown-viewer/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 3.3K
License GPL-3.0
Default branch main
Open issues 2
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

More metadata
author
BPMN diagrams are powered by Markdown Viewer — the best multi-platform Markdown extension (Chrome/Edge/Firefox/VS Code) with diagrams, formulas, and one-click Word export. Learn more at https://docu.md

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 7,256 B
  • docs SUMMARY.md 223 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 3,300 installs

SKILL.md

Business Process & Integration Diagram Generator

Quick Start: Choose diagram type → Declare stencil icons for events/gateways/tasks → Group into pools/lanes → Connect with arrow syntax → Wrap in `plantuml fence.

⚠️ IMPORTANT: Always use `plantuml or `puml code fence. NEVER use `text — it will NOT render as a diagram.

Critical Rules

  • Every diagram starts with @startuml and ends with @enduml
  • Use left to right direction for process flows (start→end reads left-to-right)
  • Use mxgraph.bpmn.* for BPMN events, gateways, and task markers
  • Use mxgraph.eip.* for Enterprise Integration Pattern icons
  • Use mxgraph.lean_mapping.* for Value Stream Mapping symbols
  • Default colors are applied automatically — you do NOT need to specify fillColor or strokeColor
  • Use rectangle "Pool" { ... } for BPMN pools and lanes
  • Sequence flows use -->, message flows use ..> (dashed)

Full stencil reference: See [stencils/README.md](../uml/stencils/README.md) for 9500+ available icons.

Mxgraph Stencil Syntax

mxgraph.<library>.<icon> "Label" as <alias>

BPMN Stencil Family (mxgraph.bpmn.*)

Events — Circle shapes for process triggers and outcomes:

Icon Meaning
mxgraph.bpmn.event.start Start Event
mxgraph.bpmn.event.end End Event
mxgraph.bpmn.event.terminateEnd Terminate End
mxgraph.bpmn.event.timerStart Timer Start
mxgraph.bpmn.event.timerCatching Timer Intermediate
mxgraph.bpmn.event.messageStart Message Start
mxgraph.bpmn.event.messageCatching Message Catching
mxgraph.bpmn.event.messageEnd Message End
mxgraph.bpmn.event.errorEnd Error End
mxgraph.bpmn.event.errorBound Error Boundary
mxgraph.bpmn.event.signalStart Signal Start
mxgraph.bpmn.event.signalEnd Signal End

Gateways — Diamond shapes for branching/merging:

Icon Meaning
mxgraph.bpmn.gateway2.exclusive Exclusive Gateway (XOR)
mxgraph.bpmn.gateway2.parallel Parallel Gateway (AND)
mxgraph.bpmn.gateway2.inclusive Inclusive Gateway (OR)
mxgraph.bpmn.gateway2.complex Complex Gateway

Tasks — Use rectangle for tasks, stencil markers for typed tasks:

Icon Meaning
mxgraph.bpmn.user_task User Task
mxgraph.bpmn.service_task Service Task
mxgraph.bpmn.script_task Script Task
mxgraph.bpmn.manual_task Manual Task
mxgraph.bpmn.businessruletask Business Rule Task

Data — Document-like shapes:

Icon Meaning
mxgraph.bpmn.data2.dataObject Data Object
mxgraph.bpmn.data2.dataInput Data Input
mxgraph.bpmn.data2.dataOutput Data Output

EIP Stencil Family (mxgraph.eip.*)

Icon Meaning
mxgraph.eip.messageChannel Message Channel
mxgraph.eip.deadLetterChannel Dead Letter Channel
mxgraph.eip.contentbasedrouter Content-Based Router
mxgraph.eip.message_filter Message Filter
mxgraph.eip.splitter Splitter
mxgraph.eip.aggregator Aggregator
mxgraph.eip.message_translator Message Translator
mxgraph.eip.content_enricher Content Enricher
mxgraph.eip.messaging_gateway Messaging Gateway
mxgraph.eip.channel_adapter Channel Adapter
mxgraph.eip.messaging_bridge Messaging Bridge
mxgraph.eip.recipient_list Recipient List
mxgraph.eip.wire_tap Wire Tap
mxgraph.eip.eventdrivenconsumer Event-Driven Consumer
mxgraph.eip.competing_consumers Competing Consumers
mxgraph.eip.process_manager Process Manager

Lean Mapping Stencil Family (mxgraph.lean_mapping.*)

Icon Meaning
mxgraph.leanmapping.outsidesources Supplier / Customer
mxgraph.leanmapping.manufacturingprocess Process Step
mxgraph.lean_mapping.supermarket Supermarket (Inventory Buffer)
mxgraph.leanmapping.fifolane FIFO Lane
mxgraph.leanmapping.productionkanban Production Kanban
mxgraph.leanmapping.withdrawalkanban Withdrawal Kanban
mxgraph.leanmapping.signalkanban Signal Kanban
mxgraph.leanmapping.truckshipment Truck Shipment
mxgraph.lean_mapping.operator Operator
mxgraph.leanmapping.inventorybox Inventory
mxgraph.leanmapping.kaizenlightening_burst Kaizen Burst
mxgraph.leanmapping.mrperp MRP / ERP System
mxgraph.lean_mapping.warehouse Warehouse
mxgraph.leanmapping.pusharrow Push Arrow
mxgraph.lean_mapping.timeline2 Timeline

Connection Types

Syntax Meaning Use Case
A --> B Solid arrow Sequence flow (task→task)
A ..> B Dashed arrow Message flow (cross-pool) / async trigger
A --> B : "label" Labeled solid Conditional flow (gateway branch)
A ..> B : "label" Labeled dashed Named message / signal

Quick Example

@startuml
left to right direction

mxgraph.bpmn.event.start "Start" as start
rectangle "Review\nRequest" as review
mxgraph.bpmn.gateway2.exclusive "Approved?" as gw
rectangle "Process\nOrder" as process
rectangle "Notify\nRejection" as reject
mxgraph.bpmn.event.end "End" as end_ok
mxgraph.bpmn.event.end "End" as end_fail

start --> review
review --> gw
gw --> process : "Yes"
gw --> reject : "No"
process --> end_ok
reject --> end_fail
@enduml

Diagram Types

Type Purpose Key Stencils Example
Order Processing E-commerce / fulfillment mxgraph.bpmn.event., mxgraph.bpmn.gateway2. [order-processing.md](examples/order-processing.md)
Approval Workflow Multi-level approval mxgraph.bpmn.event., mxgraph.bpmn.gateway2. [approval-workflow.md](examples/approval-workflow.md)
EIP Messaging Message routing & transformation mxgraph.eip.* [eip-messaging.md](examples/eip-messaging.md)
ETL Pipeline Data extraction & loading mxgraph.bpmn.event., mxgraph.eip. [etl-pipeline.md](examples/etl-pipeline.md)
Value Stream Lean manufacturing flow mxgraph.lean_mapping.* [value-stream.md](examples/value-stream.md)
Microservice Orchestration Service choreography mxgraph.bpmn.event., mxgraph.eip. [microservice-orchestration.md](examples/microservice-orchestration.md)
Event-Driven Architecture Pub/Sub event flows mxgraph.bpmn.event., mxgraph.eip. [event-driven.md](examples/event-driven.md)
Customer Service Support ticket lifecycle mxgraph.bpmn.event., mxgraph.bpmn.gateway2. [customer-service.md](examples/customer-service.md)