Skip to main content

Dapr Skills for Claude Code

A Claude Code plugin to scaffold and review Dapr Workflow applications from a natural-language spec or a workflow diagram.

View on GitHub

Scaffold from a spec

Describe the workflow in natural language and generate a runnable project in .NET, .NET Aspire, or Python.

Scaffold from a diagram

Drop a BPMN file or workflow image and generate a Dapr Workflow app in Go, Java, JavaScript, .NET, or Python.

Review existing code

Audit a workflow project for determinism, activity boundaries, and management practices.

Install​

Dapr Skills is distributed as a Claude Code plugin from the diagrid-labs/dapr-skills repository — you do not need to clone the repo.

Prerequisites: Claude Code, Docker or Podman, and the Dapr CLI (1.17+). Language-specific skills also require the matching runtime (e.g. .NET 10 SDK or Python 3.12+ with uv).

  1. 1
    Start Claude Code in the directory where you want the generated project to live.
  2. 2
    Add the marketplace and install the plugin:
    /plugin marketplace add diagrid-labs/dapr-skills
    /plugin install dapr-skills@diagrid-labs
  3. 3
    Optionally run a check-prereq-<language> skill to verify your environment before scaffolding.

Scaffold from a spec​

Describe the workflow in a prompt and the matching create-workflow-<language> skill generates a runnable Dapr Workflow project, including activity stubs, configuration, and a multi-app run file.

Supported languages​

.NET

Python

Available spec skills​

  • create-workflow-dotnet — scaffold a .NET Dapr Workflow app.
  • create-workflow-aspire — scaffold a .NET Dapr Workflow app with .NET Aspire.
  • create-workflow-python — scaffold a Python Dapr Workflow app.

Example prompt​

Create a Dapr workflow app in Python named order_processing. The workflow validates the order, then runs ReserveInventory and ProcessPayment in parallel, and finally sends an order confirmation. Input fields: Order ID, Customer name, Items (list), Total amount.

The generated project includes activity stubs, Dapr configuration, a multi-app run file, and a README.md with build and run instructions.

Scaffold from a diagram​

The create-workflow-from-diagram skill accepts a workflow image (PNG, JPG, JPEG, GIF, WebP) or a BPMN 2.0 XML file, extracts the workflow structure into an intermediate representation, validates it, and writes a runnable project in your chosen language.

Supported languages​

Go

Java

JavaScript

Python

.NET

Example prompt​

Attach a diagram or BPMN file to the chat and ask:

Create a Dapr workflow in Python from this diagram.

Scaffold a Go Dapr workflow from this BPMN file.

See skills/create-workflow-from-diagram/REFERENCE.md for the intermediate representation format and per-language notes.

Review existing code​

Audit a Dapr Workflow project for common pitfalls. Run a review skill against an existing project and Claude Code reports issues with suggested fixes.

  • review-workflow-determinism — flag non-deterministic code inside workflow functions.
  • review-workflow-activity — check activity boundaries, idempotency, and side effects.
  • review-workflow-management — review workflow lifecycle and management practices.

Run and deploy​

Once a project is scaffolded, follow the generated README.md for details on how to build and run it.

Deploy to Diagrid Catalyst for managed infrastructure, workflow visualization, and production-grade observability:

  1. 1
    Sign up for Diagrid Catalyst (free tier available)
  2. 2
    Install the Diagrid CLI
  3. 3
    Build your project per the README
  4. 4
    Run diagrid dev run -f <multi-app-run-file>
  5. 5
    View workflow execution and traces in the Catalyst console
Go deeper

Continue in your language of choice with the Workflow SDK guides — .NET, Go, Java, JavaScript, and Python. Inspect executions during local development with the Dapr Dev Dashboard, or use Workflow Composer if you prefer a hosted, diagram-first scaffolder.

Last updated on