Agent skill

Upstash Workflow Patterns

by lobehub in lobehub/lobehub

Implementation patterns for Upstash Workflow and QStash handlers in the LobeHub codebase: dry runs, fan-out chunking and single-item execution.

Custom licenceAuto-check passedBackend & APIs

Install Upstash Workflow Patterns

skills CLI
$ npx skills add lobehub/lobehub --skill upstash-workflow -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install lobehub/lobehub upstash-workflow --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/lobehub/lobehub.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/upstash-workflow .claude/skills/upstash-workflow && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
upstash-workflow
GitHub stars
83k
Token cost
~1.7k tokens
SKILL.md length
416 words
Files
5 (incl. references)
Skills in repo
50
Repo updated
First seen
Licence
Custom licence

At a glance

Implementation patterns for Upstash Workflow and QStash handlers in the LobeHub codebase: dry runs, fan-out chunking and single-item execution.

  • Works in 3 steps: Dry-Run Mode → Fan-Out Pattern → Single Task Execution
  • Adding a new Upstash Workflow handler to the LobeHub codebase
  • SKILL.md covers 🎯 The Three Core Patterns, Architecture Overview, The Three Patterns in 60 Seconds and File Structure, plus 4 more sections
  • Reaches custom-qstash.com; needs QSTASH_TOKEN

What it does

How async workflows are built in LobeHub with Upstash Workflow and QStash. Every workflow combines three patterns, each tied to a platform limit: dry-run mode, which previews what would be processed without side effects; fan-out, which splits a large batch into smaller chunks so a workflow stays under step and rate limits; and single-task execution, where each run handles exactly one item so that retries do not double-process.

Workflows follow a three-layer layout: an entry layer that validates prerequisites and counts items, a middle layer that pages through items and fans out chunks, and an execution layer that processes one item under `flowControl`. Defaults are 50 items per page and 20 per chunk. Handlers are Hono apps under `apps/server/src/router-hono/workflows/`, reached through a single catch-all Next.js route. Reference files cover best practices, cloud usage, examples such as `topicAutoSummary` and `agentEvalRun`, and implementation details.

When your agent uses it

  • Adding a new Upstash Workflow handler to the LobeHub codebase
  • Splitting a large batch job into fan-out chunks
  • Making a workflow safe to retry without double-processing
  • Adding a dry-run option that previews how many items a workflow would process

Example prompts

  • “Add a workflow that summarizes every unsummarized topic, with a dry-run mode.”
  • “Our workflow hits the step limit on big pages; split it into fan-out chunks.”
  • “Make the evaluation workflow process exactly one item per invocation.”

Requirements

  • The LobeHub codebase with its Hono workflow router
  • An Upstash Workflow and QStash setup

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Dry-Run Mode
  2. Fan-Out Pattern
  3. Single Task Execution

What it can do on your machine

Read from SKILL.md and the folder at commit 35d442e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are typescript and bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • custom-qstash.com

    Also links to:

    • upstash.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • QSTASH_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Upstash Workflow Patterns loads about 1.7k tokens when it runs, and up to ~9k if it reads all its reference files. Until then it costs about 25 tokens; SKILL.md has 416 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 416 words (~1,713 tokens).

“Standard patterns for implementing Upstash Workflow + QStash async workflows in the LobeHub codebase.”

— opening of SKILL.md by lobehub, Custom licence
name
upstash-workflow
user-invocable
false

Read the full SKILL.md on GitHub

Files

SKILL.md and 4 other files (references) in .agents/skills/upstash-workflow of lobehub/lobehub.

  • SKILL.md
  • references/best-practices.md
  • references/cloud.md
  • references/examples.md
  • references/implementation.md

Open the folder on GitHubat commit 35d442e

Compare with similar skills

Upstash Workflow Patterns next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Upstash Workflow Patterns compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Upstash Workflow Patterns this skilllobehub/lobehub83k—~1.7kAutomated safety check: PassCustom licence
Inngest SetupAsymmetric-al/core381—~3.3kAutomated safety check: NotesAGPL-3.0
Qstash JSupstash/qstash-js269—~746Automated safety check: PassMIT
Build X402 Servercoinbase/cdp-sdk203—~3.7kAutomated safety check: NotesMIT
PayRam Checkout IntegrationPayRam/payram-mcp158—~3.4kAutomated safety check: NotesNone
Bullmq Specialistsickn33/agentic-awesome-skills47k2 repos~2.5kAutomated safety check: PassMIT

Similar skills

  • Inngest Setup

    Asymmetric-al/core

    A skill your agent uses when adding durable execution to a TypeScript project — building retry-safe webhook handlers, background jobs that survive crashes, scheduled tasks, or long-running workflows…

    381 GitHub stars~3.3k tokensUpdated yesterday
    Backend & APIsAuto-check: notes
  • Qstash JS

    upstash/qstash-js

    Official

    Work with the QStash JavaScript/TypeScript SDK for serverless messaging, scheduling.

    269 GitHub stars~746 tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Build X402 Server

    coinbase/cdp-sdk

    Write code that charges for an HTTP route with the x402 protocol and receives USDC in a CDP-managed wallet.

    203 GitHub stars~3.7k tokensUpdated 3 days ago
    Backend & APIsAuto-check: notes
  • Adds crypto checkout to a web app with PayRam: create a payment from your backend, send the customer to the payment page, then confirm the result.

    158 GitHub stars~3.4k tokensUpdated yesterday
    Backend & APIsAuto-check: notes
  • Bullmq Specialist

    sickn33/agentic-awesome-skills

    BullMQ expert for Redis-backed job queues, background processing, and reliable async execution in Node.js/TypeScript applications.

    47k GitHub starsUsed in 2 repos~2.5k tokens
    Backend & APIsAuto-check passed
  • Implementing API Patterns

    ancoleman/ai-design-components

    API design and implementation across REST, GraphQL, gRPC, and tRPC patterns.

    526 GitHub stars~3k tokensUpdated 10 mo ago
    Backend & APIsAuto-check passed

More from lobehub/lobehub

All 50 skills in this repo
  • Builds single-file interactive HTML prototypes rendered with the real LobeHub UI components and written as production-style React, so they can later be split into files.

    83k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Verifies a delivery end to end by driving the real product on a CLI, web, desktop or iOS Simulator surface, capturing evidence and publishing a round with the lh CLI.

    83k GitHub stars~9.7k tokensUpdated today
    Auto-check passed
  • Git Worktree Cleanup

    lobehub/lobehub

    Audits stale Git worktrees and branches with a bundled script, classifies each one, and deletes only after you approve the exact candidates.

    83k GitHub stars~2.8k tokensUpdated today
    Auto-check passed
  • Maintains LobeHub's model-backed alint rule set: writing rules, removing false positives against real code, deciding warn versus error and tracking token cost.

    83k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Guides building LobeHub builtin agent tools, from the manifest and execution runtime to executors, chat UI renders and registry wiring.

    83k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Explains how LobeHub client code fetches data through services, SWR store hooks and cache keys, and when to avoid useEffect fetching or duplicated state.

    83k GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Categories

Questions about Upstash Workflow Patterns

What does Upstash Workflow Patterns do?

Implementation patterns for Upstash Workflow and QStash handlers in the LobeHub codebase: dry runs, fan-out chunking and single-item execution. How async workflows are built in LobeHub with Upstash Workflow and QStash. Every workflow combines three patterns, each tied to a platform limit: dry-run mode, which previews what would be processed without side effects; fan-out, which splits a large batch into smaller chunks so a workflow stays under step and rate limits; and single-task execution, where each run handles exactly one item so that retries do not double-process.

When should I use Upstash Workflow Patterns?

Upstash Workflow Patterns fits situations like: adding a new Upstash Workflow handler to the LobeHub codebase; splitting a large batch job into fan-out chunks; making a workflow safe to retry without double-processing; adding a dry-run option that previews how many items a workflow would process.

How do I install Upstash Workflow Patterns in Claude Code?

Run `npx skills add lobehub/lobehub --skill upstash-workflow -a claude-code`. Or copy the skill folder (.agents/skills/upstash-workflow in lobehub/lobehub) into .claude/skills/upstash-workflow in your project. Claude Code loads it when a task matches its description.

How do I install Upstash Workflow Patterns in Codex?

Run `npx skills add lobehub/lobehub --skill upstash-workflow -a codex`. Or copy the skill folder (.agents/skills/upstash-workflow in lobehub/lobehub) into .agents/skills/upstash-workflow in your project. Codex loads it when a task matches its description.

Can I use Upstash Workflow Patterns in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add lobehub/lobehub --skill upstash-workflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/upstash-workflow, .gemini/skills/upstash-workflow, .github/skills/upstash-workflow and .opencode/skills/upstash-workflow in your project.

What does Upstash Workflow Patterns need to run?

Going by SKILL.md and its folder, Upstash Workflow Patterns needs credentials named QSTASH_TOKEN. Our summary lists: The LobeHub codebase with its Hono workflow router; An Upstash Workflow and QStash setup.

Does Upstash Workflow Patterns access the network?

SKILL.md names 2 domains. In commands or code: custom-qstash.com; the agent is likely to contact it when it follows the instructions. As links in the text: upstash.com. This is read from the text; nothing was executed.

Is Upstash Workflow Patterns safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Upstash Workflow Patterns use?

Upstash Workflow Patterns has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Upstash Workflow Patterns use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.3k tokens, read only when the agent opens those files.

What are the alternatives to Upstash Workflow Patterns?

Skills that share tags, products or a category with Upstash Workflow Patterns: Inngest Setup (Asymmetric-al/core, 381 stars), Qstash JS (upstash/qstash-js, 269 stars), Build X402 Server (coinbase/cdp-sdk, 203 stars) and PayRam Checkout Integration (PayRam/payram-mcp, 158 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Upstash Workflow Patterns?

lobehub (a GitHub organization) maintains it in lobehub/lobehub, which has 83,074 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on October 9, 2026.

Source: lobehub/lobehub on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.