bpmn2skill

Translate BPMN 2.0 models into executable SKILL.md definitions.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/oopsyz/skills --skill bpmn2skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bpmn2skill
Source: https://github.com/oopsyz/skills/tree/main/bpmn2skill
Command: npx skills add https://github.com/oopsyz/skills --skill bpmn2skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the conversion of BPMN 2.0 models into ready-to-run SKILL.md skill units, enabling rapid translation of process diagrams into programmable AI workflows.

Core Features & Use Cases

  • Parse BPMN 2.0 elements (Start/End Events, Tasks, Service Tasks, User Tasks, Script Tasks, Gateways) and reconstruct the control-flow graph
  • Generate a complete SKILL.md with YAML frontmatter, per-task actions, inputs/outputs, prerequisites, and orchestration logic
  • Translate sequence flows, exclusive and parallel gateways into executable if/else and concurrent blocks, preserving semantics
  • Produce notes on ambiguous or unsupported constructs with suggested workarounds for maintainability
  • Use cases: policy-compliant workflow automation, design-to-code handoff, and reproducible process automation for software teams

Quick Start

Provide a BPMN 2.0 XML document and a skill name to generate a complete SKILL.md at .codex/skills/{skill_name}/SKILL.md.

Frequently Asked Questions about bpmn2skill

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

FAQPage Schema
How do I convert BPMN 2.0 models into executable AI workflows?

You translate BPMN 2.0 XML elements like tasks, gateways, and sequence flows into a SKILL.md definition. This generates a complete skill unit with YAML frontmatter, per-task actions, and orchestration logic for AI workflow automation.

How does BPMN process translation handle exclusive and parallel gateways?

BPMN process translation handles exclusive and parallel gateways by converting them into executable if/else and concurrent blocks. This preserves the original control-flow graph semantics within the generated SKILL.md orchestration logic.

Can I use BPMN models for design-to-code handoff in software engineering?

Yes, you can use BPMN models for design-to-code handoff in software engineering. Translating them into SKILL.md definitions provides developers with actionable inputs, outputs, and orchestration logic for reproducible process automation.

What is the best way to automate policy-compliant workflow generation from process diagrams?

The best way to automate policy-compliant workflow generation from process diagrams is translating BPMN 2.0 models into SKILL.md files. This captures the exact control-flow graph, prerequisites, and error handling required for strict policy compliance.

What happens to ambiguous or unsupported constructs during BPMN to SKILL.md conversion?

During BPMN to SKILL.md conversion, ambiguous or unsupported constructs generate explicit notes within the output. These notes document the unresolved elements and provide suggested workarounds to ensure long-term maintainability of the workflow.