workflow-init
vercel/workflow
Install and configure Vercel Workflow SDK for Next.js, Express, Hono, Fastify, NestJS, Nitro, Nuxt, Astro, SvelteKit, or Vite.
What is workflow-init?
Sets up the Vercel Workflow SDK in your project before the package is installed. Detects your framework, fetches the appropriate getting-started guide, and walks through installation, configuration, and verification step-by-step.
- Checks if workflow is already installed and redirects if needed
- Auto-detects your framework from package.json or prompts you to choose
- Fetches and follows the official getting-started guide for your framework
- Handles installation of dependencies and SDK configuration
- Creates and verifies your first workflow example
- Supports 10 frameworks: Next.js, Express, Hono, Fastify, NestJS, Nitro, Nuxt, Astro, SvelteKit, and Vite
How to install workflow-init
npx skills add https://github.com/vercel/workflow --skill workflow-init- An existing Node.js project with a supported framework, or willingness to create one
- package.json file in your project
How to use workflow-init
- 1.Run the install command: npx skills add https://github.com/vercel/workflow --skill workflow-init
- 2.The skill will check if workflow is already installed; if so, it will direct you to use /workflow instead
- 3.The skill auto-detects your framework from package.json or asks you to specify one
- 4.Follow the framework-specific getting-started guide that is fetched
- 5.Install dependencies as instructed in the guide
- 6.Configure your framework per the guide steps
- 7.Create your first workflow example
- 8.Start your dev server and verify with the provided curl command
Use cases
- Setting up Vercel Workflow in a new Next.js or Express project
- Adding durable workflows to an existing web application
- Initializing workflow infrastructure for API servers built with Fastify or Hono
- Configuring workflow SDK in full-stack frameworks like Nuxt or SvelteKit
- Getting started with workflows in minimal server setups using Nitro or Vite
- Backend developers building durable workflows
- Full-stack developers adding workflow capabilities to existing projects
- Teams setting up workflow infrastructure for the first time
- Developers working with Next.js, Express, Fastify, Hono, NestJS, Nitro, Nuxt, Astro, SvelteKit, or Vite
workflow-init FAQ
The skill will detect this and direct you to use the /workflow skill instead, which reads versioned docs from node_modules/workflow/docs/.
Next.js, Express, Hono, Fastify, NestJS, Nitro, Nuxt, Astro, SvelteKit, and Vite.
The skill will ask what type of project you want (web app, API server, or minimal server) and guide you through creating one before setting up Workflow.
Start your dev server per the guide, trigger the example endpoint with curl, and confirm logs show the workflow and steps executing.
Use the /workflow skill for ongoing development—it reads the versioned docs bundled in node_modules/workflow/docs/.
Full instructions (SKILL.md)
Source of truth, from vercel/workflow.
name: workflow-init description: Install and configure Vercel Workflow SDK before it exists in node_modules. Use when the user asks to "install workflow", "set up workflow", "add durable workflows", "configure workflow sdk", or "init workflow" for Next.js, Express, Hono, Fastify, NestJS, Nitro, Nuxt, Astro, SvelteKit, or Vite. metadata: author: Vercel Inc. version: '1.3'
workflow-init
Initial setup of Vercel Workflow SDK before workflow is installed. Fetch the official getting-started guide for the user's framework.
Decision Flow
0) Sanity check
Read package.json. If workflow is already a dependency, tell the user to use /workflow instead (it reads versioned docs from node_modules/workflow/docs/). Only continue if workflow is missing.
1) Determine the framework
Non-interactive: If the user named a framework in their prompt, use it directly.
Auto-detect: Inspect package.json deps and config files. Use the first match:
- Next.js -
nextdep ornext.config.* - Nuxt -
nuxtdep ornuxt.config.* - SvelteKit -
@sveltejs/kitdep orsvelte.config.* - Astro -
astrodep orastro.config.* - NestJS -
@nestjs/coredep ornest-cli.json - Nitro -
nitrodep ornitro.config.* - Express -
expressdep - Fastify -
fastifydep - Hono -
honodep - Vite -
vitedep (and not matched above)
If no match or multiple matches, ask the user to pick.
2) Fetch and follow the getting-started guide
Fetch exactly one of these URLs and follow the guide step-by-step:
Each guide covers: install deps, configure framework, create first workflow, create route handler, run + verify.
3) Verify setup
- Start the dev server per the guide.
- Trigger the example endpoint with the provided
curl. - Confirm logs show the workflow and steps executing.
- Optional:
npx workflow webornpx workflow inspect runs.
4) No framework yet?
If no framework exists, ask what the user wants:
- Web app: Next.js / Nuxt / SvelteKit / Astro
- API server: Express / Fastify / Hono
- Minimal server: Nitro or Vite
Then follow the "Create Your Project" section of the chosen guide.
Concept questions (pre-install)
If the user asks conceptual questions before installing, fetch:
Handoff
When setup is complete, tell the user: Use /workflow for ongoing development - it reads the versioned docs bundled in node_modules/workflow/docs/.
Related skills
More from vercel/workflow and the wider catalog.
workflow
Build durable, resumable workflows that survive restarts and coordinate multi-step operations.
agent-integration
Integrate a raw customer agent repo with Veris end to end. Installs or verifies veris-cli, logs in, creates or reuses a Veris environment, analyzes the repo, generates or updates `.veris/veris.yaml`, `.veris/Dockerfile.sandbox`, `.veris/.dockerignore`, configures runtime env vars, and can finish with `veris env push`. Use when a repo has no Veris setup yet, or when an existing `.veris/` integration is stale and needs to be refreshed.
claude-typer
Render a Claude-style prompt typing animation video by calling Remotion CLI against the remote site https://www.laosunwendao.com. Use when the user asks for "做一个 claude 的提示词打字机动画", "做 Claude 打字动画", "创建提示词动画", or similar requests that convert a text prompt into a typing-animation video.
procedural-fish-render
Clone or update https://github.com/vibe-motion/procedural-fish and render procedural-fish animation to a video using the project's own render command. Use when the user asks to render 程序鱼/procedural fish, export a 程序鱼视频, or run procedural-fish Remotion rendering.
svg-assembly-animator
为 SVG 矢量图创建充满“力量感”与“速度感”的零件组装动画，并支持一键导出 30fps 的透明背景序列帧。适用于需要将静态 SVG 转换为可用于视频剪辑（如 AE/PR）的透明素材场景。
vibe-check
Browser automation for AI agents. Use when the user needs to navigate websites, read page content, fill forms, click elements, take screenshots, or manage browser pages.