vercel avatar

Workflow Init

This handles the first-time setup of Vercel's Workflow SDK across ten different frameworks, from Next.js to Vite. It auto-detects your stack by reading package.json, fetches the correct getting-started guide from workflow-sdk.dev, and walks through installation, configuration, and verification. The smart bit is the sanity check: if workflow is already installed, it tells you to use the /workflow skill instead, which reads from the versioned docs in node_modules. It's basically a framework-aware bootstrap script that knows when to hand off. If you're adding durable workflows to an existing project or starting fresh, this gets you to a working example endpoint without hunting through docs.

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

Install

$ npx -y skills add vercel/workflow --skill workflow-init --agent claude-code

Installs into .claude/skills of the current project.

Files

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:

  1. Next.js - next dep or next.config.*
  2. Nuxt - nuxt dep or nuxt.config.*
  3. SvelteKit - @sveltejs/kit dep or svelte.config.*
  4. Astro - astro dep or astro.config.*
  5. NestJS - @nestjs/core dep or nest-cli.json
  6. Nitro - nitro dep or nitro.config.*
  7. Express - express dep
  8. Fastify - fastify dep
  9. Hono - hono dep
  10. Vite - vite dep (and not matched above)

If no match or multiple matches, ask the user to pick.

Sponsors

Details

Repository
github.com/vercel/workflow
Categories
Frontend Development, Automation & Workflows, Cloud & Infrastructure
First seen
Apr 16, 2026

More from vercel/workflow

All 3
1dotnet avatarmaui-safe-areadotnet/skills.NET MAUI safe area and edge-to-edge layout guidance for .NET 10+. Covers the new SafeAreaEdges property, SafeAreaRegions enum, per-edge control, keyboard avoid3.9Kskills.sh installs
2markdown-viewer avatarumlmarkdown-viewer/skillsCreate UML diagrams using PlantUML syntax. Best for software modeling — Class, Sequence, Activity, State Machine, Component, Use Case, and Deployment diagrams w3.9Kskills.sh installs
3dotnet avatarconfigure-authdotnet/skillsAdd authentication and authorization to a Blazor Web App, accounting for the app's render mode. USE WHEN the user needs [Authorize] on pages, AuthorizeView, rol3.9Kskills.sh installs
4anthropics avatardesign-handoffanthropics/knowledge-work-pluginsGenerate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component prop3.8Kskills.sh installs
5dotnet avatarcreate-blazor-projectdotnet/skillsCreate a new ASP.NET Core web application or web site using Blazor. USE FOR: creating a new Blazor web app, scaffolding a new web project, starting a new web si3.8Kskills.sh installs
6dotnet avatarcollect-user-inputdotnet/skillsBuild forms, validate data, and react to user input in Blazor. USE FOR adding forms, search boxes, filter panels, inline editing, data-entry UI, file uploads, v3.7Kskills.sh installs