Labsco
vercel logo

workflow-init

✓ Official★ 2,200

by vercel · part of vercel/workflow

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…

🔥🔥🔥✓ VerifiedFreeQuick setup
#automation#git
🧰 Not standalone. This skill ships with vercel/workflow and only works together with that tool — install the tool first, then add this skill.

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…

Inspect the full instructions your agent will receiveExpand

This is the exact playbook injected into your agent when the skill activates — shown here so you can audit it before installing. You don't need to read it to use the skill.

by vercel

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… npx skills add https://github.com/vercel/workflow --skill workflow-init Download ZIPGitHub2.2k

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 - next dep or next.config.*

  • Nuxt - nuxt dep or nuxt.config.*

  • SvelteKit - @sveltejs/kit dep or svelte.config.*

  • Astro - astro dep or astro.config.*

  • NestJS - @nestjs/core dep or nest-cli.json

  • Nitro - nitro dep or nitro.config.*

  • Express - express dep

  • Fastify - fastify dep

  • Hono - hono dep

  • Vite - vite dep (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:

Framework URL Next.js https://workflow-sdk.dev/docs/getting-started/next Express https://workflow-sdk.dev/docs/getting-started/express Hono https://workflow-sdk.dev/docs/getting-started/hono Fastify https://workflow-sdk.dev/docs/getting-started/fastify NestJS https://workflow-sdk.dev/docs/getting-started/nestjs Nitro https://workflow-sdk.dev/docs/getting-started/nitro Nuxt https://workflow-sdk.dev/docs/getting-started/nuxt Astro https://workflow-sdk.dev/docs/getting-started/astro SvelteKit https://workflow-sdk.dev/docs/getting-started/sveltekit Vite https://workflow-sdk.dev/docs/getting-started/vite

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 web or npx 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.

Handoff

When setup is complete, tell the user: Use /workflow for ongoing development - it reads the versioned docs bundled in node_modules/workflow/docs/.