create-process-adapter

Generate or update Zeebe process out-adapters in Kotlin from BPMN models.

3|Updated Feb 6, 2025
One-click install
npx skills add https://github.com/emaarco/easy-zeebe --skill create-process-adapter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-process-adapter
Source: https://github.com/emaarco/easy-zeebe/tree/main/.claude/skills/create-process-adapter
Command: npx skills add https://github.com/emaarco/easy-zeebe --skill create-process-adapter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation and updating of outbound adapters for Zeebe processes, ensuring your application can reliably interact with the process engine.

Core Features & Use Cases

  • Automated Adapter Generation: Creates Kotlin classes for starting processes, sending messages, and triggering signals based on BPMN models or ProcessApi definitions.
  • Type-Safe Constants: Enforces the use of constants defined in ProcessApi files, preventing errors from raw string literals.
  • Update Existing Adapters: Modifies existing adapter files to include missing methods or correct outdated constant references.
  • Use Case: When you define a new process in BPMN or update your ProcessApi.kt file, use this Skill to automatically generate or update the corresponding Kotlin adapter code that your service will use to interact with Zeebe.

Quick Start

Use the create-process-adapter skill to generate an outbound adapter for the 'newsletter-subscription' process.

Frequently Asked Questions about create-process-adapter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate Kotlin adapters for Zeebe process automation?

To generate Kotlin adapters for Zeebe process automation, provide the Skill with a BPMN model, ProcessApi file, or plain description. It outputs type-safe Kotlin classes for outbound communication with the process engine.

Can I update an existing Zeebe process adapter with new BPMN changes?

Yes, you can update an existing Zeebe process adapter by providing the updated BPMN or ProcessApi definitions. The Skill modifies existing Kotlin files to add missing methods and correct stale constant references.

What are type-safe constants in Zeebe process adapters and why are they needed?

Type-safe constants in Zeebe process adapters are fixed references defined in ProcessApi files used instead of raw string literals. They are needed to prevent runtime errors and ensure application consistency with process definitions.

Does this adapter generation approach work with plain text process descriptions?

Yes, adapter generation works with plain text descriptions. The Skill can create Zeebe out-adapters in Kotlin directly from plain descriptions, ensuring type-safe integration and adherence to best practices.

How do I start a Zeebe process or send messages using a generated Kotlin adapter?

To start a Zeebe process or send messages, use the generated Kotlin adapter classes. The adapter generation creates specific methods for starting processes, sending messages, and triggering signals based on your BPMN models.

Why are my raw string literals failing in Zeebe process integration?

Raw string literals fail in Zeebe process integration because they lack type safety and can become outdated. Using generated adapters enforces constants defined in ProcessApi files, correcting stale references and preventing errors.