---
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

1. **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.

2. **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.

3. **Translate BPMN Control Flow into Executable Skill Logic**
   - Convert sequence flows into step-by-step execution rules.
   - Convert exclusive gateways into `if/else` decision blocks.
   - Convert parallel gateways into concurrent execution blocks.
   - Ensure the resulting skill is deterministic and runnable.

4. **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) and `description` fields
     - Title
     - Description
     - Inputs
     - Actions
     - Orchestration logic
     - Error handling
     - Any assumptions made during translation

5. **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
1. **Skill Name**: The name for the new skill (provided by the user)
2. **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.