bpmn2skill
Generate a complete SKILL.md by parsing a BPMN 2.0 XML process and translating tasks, gateways, and events into skill actions and orchestration logic.
When & Why to Use This Skill
This Claude skill automates the conversion of BPMN 2.0 XML process models into structured SKILL.md files for AI agents. It intelligently parses business workflows—including tasks, gateways, and events—and translates them into executable agent actions, orchestration logic, and YAML frontmatter, bridging the gap between visual business process modeling and autonomous agent implementation.
Use Cases
- Enterprise Workflow Automation: Rapidly transform existing corporate BPMN diagrams into functional AI agent definitions to automate complex business processes.
- Agent Development Efficiency: Accelerate the scaffolding of new agent skills by automatically generating boilerplate SKILL.md files from visual process designs.
- Business-IT Alignment: Ensure that AI agent behavior strictly adheres to documented business requirements by using BPMN 2.0 XML as the single source of truth for agent logic.
- Legacy Process Migration: Modernize traditional business workflows by converting legacy XML process definitions into modern, AI-driven agentic skill sets.
| name | bpmn2skill |
|---|---|
| description | Generate a complete SKILL.md by parsing a BPMN 2.0 XML process and translating tasks, gateways, and events into skill actions and orchestration logic. |
bpmn2skill
Overview
You are a SkillBuilder agent. Your job is to take a BPMN 2.0 XML document as input and generate a complete SKILL.md file that implements the process described in the BPMN model.
Your Responsibilities
Parse the BPMN 2.0 XML
- Identify all Start Events, End Events, Tasks, Service Tasks, User Tasks, Script Tasks, and Gateways.
- Extract sequence flows and reconstruct the control-flow graph.
- Preserve the original process semantics.
Generate a New Skill Definition (SKILL.md)
- MUST start with YAML frontmatter delimited by
---containing:name: Use the skill name provided by the user (do not derive from BPMN)description: A brief description of what the skill does
- For each BPMN Task, generate a corresponding skill action with:
- A clear description
- Input schema
- Output schema
- Preconditions and postconditions
- For each Gateway, generate conditional logic in the skill's orchestration section.
- For each Event, generate appropriate triggers or termination conditions.
- MUST start with YAML frontmatter delimited by
Translate BPMN Control Flow into Executable Skill Logic
- Convert sequence flows into step-by-step execution rules.
- Convert exclusive gateways into
if/elsedecision blocks. - Convert parallel gateways into concurrent execution blocks.
- Ensure the resulting skill is deterministic and runnable.
Output Format and File Creation
- MUST create the skill file at:
.codex/skills/{skill_name}/SKILL.md- Create the directory structure if it doesn't exist
- Use the exact skill name provided by the user for the directory name
- Produce a complete SKILL.md file in valid Markdown.
- MUST begin with YAML frontmatter delimited by
---(e.g.,---\nname: skillname\ndescription: ...\n---) - Include:
- YAML frontmatter with
name(using user-provided name) anddescriptionfields - Title
- Description
- Inputs
- Actions
- Orchestration logic
- Error handling
- Any assumptions made during translation
- YAML frontmatter with
- MUST create the skill file at:
Constraints
- Do not omit any BPMN tasks or flows.
- Preserve the original intent of the workflow.
- If the BPMN contains ambiguous or unsupported constructs, document them clearly in a "Notes & Assumptions" section.
Input
- Skill Name: The name for the new skill (provided by the user)
- BPMN 2.0 XML document: The BPMN process definition to translate
Output
A fully generated SKILL.md file created at .codex/skills/{skill_name}/SKILL.md that implements the BPMN workflow, where {skill_name} is the name provided by the user.