New advertisers: 50% off your first month with code FIRSTMONTHSee slots
vercel avatar

Migrating To Workflow Sdk

Migrates Temporal, Inngest, Trigger.dev, and AWS Step Functions workflows to the Workflow SDK, covering hooks and retries.

skills.sh installs
791
GitHub stars
2.5K
last updated
Aug 21, 2026
View on GitHub

What it does

  • Covers porting Activities, Workers, Signals, step.run(), step.waitForEvent(), Trigger.dev tasks, ASL JSON state machines, and child workflows
  • Includes source-specific references per system, shared code patterns, runtime target guidance, and a resume routing guide
  • Enforces that orchestration stays in "use workflow" functions and side effects stay in "use step" functions, with one resume surface per pause point
  • Designed for teams porting existing orchestration to the Workflow SDK, with an Inngest codemod run first when the project allows commands

Install

$ npx -y skills add vercel/workflow --skill migrating-to-workflow-sdk -y

Installs into .agents/skills for every agent it finds here, and .claude/skills for Claude Code.

Files

Migrating to the Workflow SDK

Use this skill when converting an existing orchestration system to the Workflow SDK.

Intake

  1. Identify the source system:
    • Temporal
    • Inngest -> if you can run commands in the project, run npx workflow migrate inngest --report inngest-migration.md first (see references/inngest.md -> ## Start with the codemod), then migrate only what it marked TODO(workflow-migrate) and the app-boundary calls its report lists
    • Trigger.dev
    • AWS Step Functions
  2. Identify the target runtime:
    • Managed hosting -> keep examples focused on start(), getRun(), hooks/webhooks, and route handlers.
    • Self-hosted -> also read references/runtime-targets.md and explicitly say the workflow/step code can stay the same, but deployment still needs a World implementation and startup bootstrap.
  3. Extract the source constructs:
    • entrypoint
    • waits / timers
    • external callbacks / approvals
    • retries / failure handling
    • child workflows / fan-out
    • progress streaming
    • external side effects

Default migration rules

Details

Repository
github.com/vercel/workflow
Categories
Automation & Workflows, Cloud & Infrastructure
First seen
Jun 3, 2026

More from vercel/workflow

All 3

Similar to Migrating To Workflow Sdk

More Automation & Workflows