workflow-init
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.
Security Assessment
About workflow-init
The workflow-init skill automates the initial setup and configuration of the Vercel Workflow SDK in web and API projects before the package exists in node_modules. It intelligently detects your project framework or guides you through framework selection, then fetches and executes the appropriate getting-started guide to get durable workflows running in your application. This skill solves the cold-start problem of integrating a new SDK by handling dependency installation, framework configuration, example workflow creation, and verification in one guided flow.
The skill supports ten popular JavaScript frameworks including Next.js, Express, Hono, Fastify, NestJS, Nitro, Nuxt, Astro, SvelteKit, and Vite. It performs intelligent framework detection by analyzing package.json dependencies and configuration files, eliminating manual framework specification in most cases. The skill fetches official, framework-specific documentation from workflow-sdk.dev and walks through each setup step including installing dependencies, configuring the framework integration, creating a first workflow with steps, setting up route handlers, and running verification tests using curl and CLI tools.
This skill is designed for developers who want to add durable workflow capabilities to their existing projects or start new projects with workflow orchestration built-in. It's particularly useful for backend and full-stack developers building applications that need reliable, long-running processes like payment processing, data pipelines, notification systems, or multi-step user onboarding flows. Once setup is complete, the skill hands off to the main /workflow command which provides ongoing development assistance using the versioned documentation bundled in node_modules.
FAQ
What happens if workflow is already installed in my project?
The skill performs a sanity check by reading package.json first. If workflow is already listed as a dependency, it will direct you to use the /workflow command instead, which reads versioned documentation from node_modules/workflow/docs/. This skill only runs when workflow is not yet installed.
Which frameworks are supported for Vercel Workflow SDK setup?
The skill supports ten frameworks: Next.js, Express, Hono, Fastify, NestJS, Nitro, Nuxt, Astro, SvelteKit, and Vite. It can auto-detect your framework by analyzing dependencies and config files, or you can specify the framework explicitly in your request.
What if I don't have a framework set up yet?
If no framework is detected, the skill will ask what type of project you want to build: web app (Next.js, Nuxt, SvelteKit, Astro), API server (Express, Fastify, Hono), or minimal server (Nitro, Vite). It will then guide you through the 'Create Your Project' section of the chosen framework's getting-started guide.
How does the skill verify that the setup worked correctly?
After configuration, the skill starts the dev server according to the framework guide, triggers the example workflow endpoint using curl, and confirms that logs show the workflow and steps executing properly. It can also optionally run npx workflow web or npx workflow inspect runs for additional verification.
Can I ask conceptual questions about workflows before installing?
Yes, if you ask conceptual questions before installation, the skill will fetch documentation from workflow-sdk.dev/docs/foundations/workflows-and-steps and the cookbook to provide explanations without requiring the SDK to be installed first.
Install workflow-init
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
vercel/workflow