upstash-workflow
LobeHub Upstash Workflow and QStash guide. Use for async workflows, process/paginate/execute fan-out, serve handlers, context.run/call/sleep, or workflow triggers.
Profile →npx skills add lobehub/lobehub --skill upstash-workflow --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Upstash Workflow Implementation Guide Standard patterns for implementing Upstash Workflow + QStash async workflows in the LobeHub codebase. ## 🎯 The Three Core Patterns Every workflow in LobeHub combines these three patterns. They exist because the platform constrains you in three ways: rate limits make blind fan-out dangerous, step limits cap a single workflow's size, and idempotency demands that retries don't double-process. 1. **🔍 Dry-Run Mode** — get statistics without triggering actual execution 2. **🌟 Fan-Out Pattern** — split large batches into smaller chunks for parallel processing 3. **🎯 Single Task Execution** — each workflow execution processes **exactly ONE item** --- ## Architecture Overview All workflows follow the same 3-layer architecture: ```text Layer 1: Entry Point (process-*) ├─ Validates prerequisites ├─ Calculates total items to process ├─ Filters existing items ├─ Supports dry-run mode (statistics only) └─ Triggers Layer 2 if work is needed Layer 2: Pagination (paginate-*) ├─ Handles cursor-based pagination ├─ Implements fan-out for large batches ├─ Recursively processes all pages └─ Triggers Layer 3 for each item Layer 3: Single Task Execution (execute
- 🎯 The Three Core Patterns
- Architecture Overview
- The Three Patterns in 60 Seconds
- 1. Dry-Run Mode
- 2. Fan-Out Pattern
- 3. Single Task Execution
- File Structure
- Where to Go Next
- Environment Variables
- Checklist for New Workflows
- Planning
- Implementation
- Quality & Deployment
- Additional Resources
Required for all workflows Optional (for custom QStash URL)
What does the upstash-workflow skill do?
LobeHub Upstash Workflow and QStash guide. Use for async workflows, process/paginate/execute fan-out, serve handlers, context.run/call/sleep, or workflow triggers.
How do I install it?
Run `npx skills add lobehub/lobehub --skill upstash-workflow --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From lobehub/lobehub, a repository with 81,252 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.