help

# Help Skill

Display help information for the bpmn-plugin skills.

**IMPORTANT:** This skill must be updated whenever skills are added, changed, or removed from this plugin.

## Usage

```
/help                          # Show all skills
/help <skill-name>             # Show detailed help for a specific skill
```

## Mode 1: List All (no arguments)

When invoked without arguments, display this table:

```
bpmn-plugin Skills
==================

| Skill | Description |
|-------|-------------|
| /bpmn-generator | Generate BPMN 2.0 XML from natural language or markdown documents |
| /bpmn-to-drawio | Convert BPMN XML to Draw.io format for visual editing |
| /help | Show available skills in this plugin with usage information |

---
Use '/help <name>' for detailed help on a specific skill.
```

## Mode 2: Detailed Help (with argument)

When invoked with a skill name, display detailed information.

### Skill Reference

---

#### /bpmn-generator
**Description:** Generate BPMN 2.0 compliant XML files from natural language process descriptions or structured markdown documents. Creates complete process definitions with proper namespaces, Diagram Interchange (DI) data for rendering, and phase comments for PowerPoint compatibility.

**Operating Modes:**
- **Interactive Mode**: When given a natural language description (no file), conducts structured Q&A to gather requirements across 7 phases (scope, participants, activities, flow control, events, data, optimization).
- **Document Parsing Mode**: When given a markdown file path, extracts process elements from headings, numbered lists, and document structure.

**Arguments:** `[description or file.md]` `[--preview]`
**Output:** `[process-name].bpmn` - BPMN 2.0 compliant XML file

**Examples:**
```
/bpmn-generator                           # Interactive mode - guided Q&A
/bpmn-generator "order fulfillment flow"  # Interactive mode with initial description
/bpmn-generator process-doc.md            # Document parsing mode
/bpmn-genera