Agent skill · software engineering · upstash
upstash-workflow-js
Work with the @upstash/workflow TypeScript/JavaScript SDK for durable, long-running workflows in serverless functions, multi-step processes that survive timeouts, retries, and restarts (built on QStash). Use when defining a workflow endpoint with serve(), running steps with context.run, sleeping for minutes to days without holding a function open, calling external APIs with context.call, waiting for an external event or webhook, invoking other workflows, configuring retries, failure callbacks, and a DLQ, controlling concurrency, rate, and parallelism, triggering, cancelling, or inspecting runs with the Workflow client, building AI agents and orchestrators, human-in-the-loop approvals, realtime updates, local development with the QStash dev server, adding middleware, or migrating workflows safely. Also use when the user asks for durable execution, step functions, saga or orchestration patterns, background jobs with checkpoints, or long-running tasks on Vercel, Next.js, Cloudflare Workers, or other serverless platforms.
Why this skill is useful
Provides specific commands and patterns for defining and managing workflows using the Upstash Workflow SDK that the AI wouldn't reliably generate on its own.
What it needs
Requires @upstash/workflow installed locally. About 2k tokens when loaded. Last updated 2026-07-14. 17 stars on the source repository.
What this skill does
Upstash Workflow SDK Quick Start The Upstash Workflow SDK lets you expose serverless workflow endpoints and run them reliably using QStash under the hood. Install: Define a simple workflow endpoint: Trigger it from your backend: Other Skill Files These files contain the full documentation. Use them for details, patterns, and advanced behavior. basics: basics/serve – How to expose workflow endpoints. basics/context – Full API for workflow context (steps, waits, webhooks, events, invoke, etc.). basics/client – Using the Workflow client to trigger, cancel, inspect, and notify runs. features: features/invoke – Cross‑workflow invocation. features/reliability – Retries, failure callbacks, and DLQ. features/flow-control – Rate limits, concurrency, and parallelism. features/wait-for-event – Notify and wait-for-event patterns. features/webhooks – Webhook creation and consumption. how to: how-to/local-dev – Local QStash dev server (auto via QSTASHDEV=true) and tunneling. how-to/realtime – Realtime and human‑in‑the‑loop workflows. how-to/migrations – Migrating workflows safely. how-to/middleware – Adding middleware to workflows. other files: rest-api – Low-level REST endpoints for interacting with QStash/Workflow. troubleshooting – Common debugging and environment issues. agents – Using Workflow with agents, orchestrators, and automation patterns.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills upstash/upstash-workflow-js