# Bpmn Export

> Export a BPMN file to an image using npx bpmn-to-image. Defaults to SVG; PNG and PDF available on request. Use when asked to export, render, or convert a .bpmn diagram to an image.

- Skill: `emaarco/bpmn-export` (Agent Skill)
- Install (CLI): `npx skillmds@latest add emaarco/bpmn-export`
- Raw SKILL.md: https://api.skillmd.com/api/skills/emaarco/bpmn-export/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: emaarco (https://skillmd.com/u/emaarco)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/emaarco/bpmn-export

---


# Skill: bpmn-export

Exports a BPMN file to an image using `npx bpmn-to-image`.

## Steps

### 1. Identify the source file

If the user has not provided a `.bpmn` file path, ask which file to export.

Default the output format to **SVG** — only produce `.png` or `.pdf` if the user explicitly asks for that format. Do not ask which format they want; assume SVG unless told otherwise.

### 2. Determine output path

Default: `<module-root>/assets/<basename>.<ext>`, where the module root is the nearest ancestor directory of the BPMN file containing a build manifest (`package.json`, `pom.xml`, `build.gradle`, …). If the repo has no module structure, use `assets/` at the repo root. Ask if unsure.

### 3. Run the export

Use `--yes` so npx installs the package without prompting (a plain `npx` call hangs on the install confirmation in non-interactive runs):

```bash
npx --yes bpmn-to-image <path-to-bpmn>:<path-to-output-image>
```

Example:
```bash
npx --yes bpmn-to-image services/example-service/src/main/resources/bpmn/membership.bpmn:services/example-service/assets/membership.svg
```

### 4. Confirm

Report the output path to the user and confirm the export succeeded.