Skip to content

🧠 AI Agent Skills ​

Beta

Agent skills are in beta. Skill names and instructions may change in a future release. Leave feedback if you're using them.

bpmn-to-code ships with reusable skills for AI coding assistants. Skills work with Claude Code out of the box.

Available Skills ​

SkillDescription
setup-bpmn-to-code-gradleSet up the Gradle plugin in an existing project. Detects project structure, BPMN files, and output language.
setup-bpmn-to-code-mavenSet up the Maven plugin in an existing project. Adds plugin configuration to pom.xml.
migrate-to-bpmn-to-code-apisReplace hardcoded BPMN strings with references to the generated Process API. Scans source code and shows a migration plan before applying changes.
migrate-bpmn-to-code-v1-to-v2Migrate generated API references from v1.1.0 to v2.0.0. Finds TaskTypes → ServiceTasks renames, moved BpmnTimer/BpmnError imports, and flags variable path changes for manual review.

Installation ​

Install as a Claude Code plugin:

bash
/plugin marketplace add emaarco/bpmn-to-code
/plugin install bpmn-to-code@bpmn-to-code

Alternative: npx skills ​

Install skills using npx skills:

bash
# Install all skills at once
npx skills add https://github.com/emaarco/bpmn-to-code

# Or pick only what you need
npx skills add https://github.com/emaarco/bpmn-to-code/tree/main/.claude/skills/setup-bpmn-to-code-gradle
npx skills add https://github.com/emaarco/bpmn-to-code/tree/main/.claude/skills/setup-bpmn-to-code-maven
npx skills add https://github.com/emaarco/bpmn-to-code/tree/main/.claude/skills/migrate-to-bpmn-to-code-apis
npx skills add https://github.com/emaarco/bpmn-to-code/tree/main/bpmn-to-code-skills/skills/migrate-bpmn-to-code-v1-to-v2

How Skills Work ​

Skills are Markdown-based prompt definitions stored in .claude/skills/. When an AI assistant recognizes a matching task, it loads the skill and follows its instructions. Skills provide:

  • Step-by-step workflows for common tasks
  • Context about the project's conventions and patterns
  • Safety checks (e.g. read-only until confirmation)
  • References to canonical examples in the repository