vercel avatar

Migrating To Workflow Sdk

This does the heavy lifting when you're porting existing orchestration code from Temporal, Inngest, Trigger.dev, or AWS Step Functions into the Workflow SDK. It knows how to map Activities to steps, Signals to hooks or webhooks, wait-for-event patterns to the right resume surface, and state machines to workflow functions. The routing logic is strict: it picks between internal hooks with deterministic tokens, auto-acknowledged webhooks, or manual-response webhooks based on what your prompt actually requires, and it fails the draft if you mix primitives that don't belong together. Worth using when you have working orchestration elsewhere and need a clean migration path that respects idempotency, streaming, retries, and the use-workflow versus use-step boundary.

skills.sh installs
776
GitHub stars
2.5K
last updated
Aug 21, 2026

Install

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

Installs into .claude/skills of the current project.

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
    • 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

Sponsors

Details

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

More from vercel/workflow

All 3
1ruvnet avatarworkflow-runruvnet/rufloRun a workflow — drive an MCP workflow lifecycle (execute/pause/resume/cancel) or invoke + resume a native .claude/workflows/*.js orchestration via the Workflow744skills.sh installs
2jwynia avatardocx-generatorjwynia/agent-skillsCreate and manipulate Word DOCX files programmatically. Use when the user needs to generate documents, modify DOCX templates, extract document content, or autom736skills.sh installs
3akin-ozer avatarazure-pipelines-generatorakin-ozer/cc-devops-skillsGenerate/create/scaffold azure-pipelines.yml, stages, jobs, steps, or reusable templates.692skills.sh installs
4akin-ozer avatargitlab-ci-generatorakin-ozer/cc-devops-skillsCreate, generate, or scaffold .gitlab-ci.yml pipelines, stages, and jobs.686skills.sh installs
5joellewis avatarstp-automationjoellewis/finance_skillsMeasure and raise straight-through processing (STP) rates in securities operations through zero-touch, exception-based processing. Use when measuring STP rates 686skills.sh installs
6akin-ozer avatargithub-actions-generatorakin-ozer/cc-devops-skillsCreate, generate, or scaffold GitHub Actions workflows, action.yml, or .github/workflows CI/CD pipelines.684skills.sh installs