vercel-queues

Implements durable event streaming on Vercel Queues with topics, consumer groups, and retries.

Updated Jul 31, 2026
One-click install
npx skills add https://github.com/AarnavBaddam/skills --skill vercel-queues-aarnavbaddam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vercel-queues
Source: https://github.com/AarnavBaddam/skills/tree/main/vercel-queues
Command: npx skills add https://github.com/AarnavBaddam/skills --skill vercel-queues-aarnavbaddam

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @vercel/queue.

What problem does it solve? Vercel Queues entered public beta in February 2026 and is absent from AI training data, so generated queue code is often wrong. This Skill provides accurate guidance for building asynchronous, event-driven processing on Vercel's durable event streaming platform. ## Core Features & Use Cases - Message Publishing: Send messages to topics with delaySeconds, idempotency keys, custom retention, and headers using the @vercel/queue SDK. - Consumer Patterns: Implement push-mode consumers via handleCallback route handlers with visibility timeouts and retry policies, or poll-mode consumers with PollingQueueClient for external infrastructure. - Architecture Guidance: Choose correctly between Queues, Workflow, and Cron Jobs based on fan-out, orchestration, and scheduling needs. - Use Case: You need to defer order fulfillment emails after checkout. Publish an event to an 'order-events' topic, configure a consumer group route with exponential backoff retries, and monitor consumer lag via the Queues observability tab. ## Quick Start Ask the AI to set up a Vercel Queue consumer that processes messages from an 'order-events' topic with retries and delayed delivery.

Frequently Asked Questions about vercel-queues

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish messages to a Vercel Queue topic?

Use the send function from @vercel/queue with the topic name and message payload. Options include delaySeconds for delayed delivery, idempotencyKey for deduplication, retentionSeconds for TTL, and custom headers.

Vercel Queues vs Workflow vs Cron Jobs: which should I use?

Use Queues for event delivery, fan-out, and message-level retries; Workflow for stateful multi-step orchestration with deterministic replay; Cron Jobs for recurring scheduled tasks. Workflow is built on top of Queues.

How do I set up a queue consumer in a Next.js app?

Create a route handler using handleCallback from @vercel/queue, then register it in vercel.json under functions with an experimentalTriggers entry of type queue/v2beta specifying the topic. Multiple routes on one topic create independent consumer groups.

Can I consume Vercel Queue messages outside of Vercel?

Yes, use PollingQueueClient with a specified region to poll messages from any infrastructure. In non-Vercel environments, set the VERCEL_QUEUE_API_TOKEN environment variable for authentication instead of OIDC.

What are the limits of Vercel Queues messages?

Messages can be up to 100 MB with retention from 60 seconds to 24 hours. Receives return 1-10 messages per poll, visibility timeouts range from 0 seconds to 60 minutes, and billing is $0.60 per million operations metered in 4 KiB chunks.

Why are my queue messages delivered to the wrong deployment?

Topics are partitioned by deployment ID in push mode, so messages return to the publishing deployment by design. This provides natural schema versioning; use poll mode if you need cross-deployment consumption.