CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

queues

Vercel Queues guidance — durable topics with at-least-once delivery, independent consumer groups, retries, delays, and idempotency keys via @vercel/queue (JS) or vercel-queue (Python). Use when deferring background work, buffering traffic, fanning out events, or choosing between Queues and Workflows.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

82%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-crafted reference skill: fully executable JS quickstart covering publish, consume, and trigger registration, plus concrete options tables, a poison-message retry policy, and a pitfalls section that doubles as error-recovery guidance. Structure is clear with external doc links; the only gaps are a missing explicit verification checkpoint after setup and a few common synonyms in the description rather than the body.

DimensionReasoningScore

Conciseness

The body is dense and token-efficient: option tables, a decision table, and compact code blocks with inline comments ("retentionSeconds: 3600, // message TTL; min 60, max 604800"). Minor trimmable padding remains — the "You are an expert in Vercel Queues..." opener and slight redundancy between the retention facts in 'What It Is' and the Send Options table — placing it at the 'efficient; minor instances of over-explanation' (4) anchor rather than the fully lean 5.

4 / 5

Actionability

Guidance is copy-paste ready throughout: install command, send() publish route, handleCallback consumer, the vercel.json experimentalTriggers registration, QueueClient construction, and a concrete retry policy with a backoff formula ("Math.min(300, 2 ** metadata.deliveryCount * 5)"). It matches the 5 anchor — fully executable code covering the common cases; it is not 4 because there are no pseudocode or missing key details in the core JS path.

5 / 5

Workflow Clarity

The Quickstart sequences install → publish → consume → register trigger → vercel link/env pull, and the 'Common Pitfalls' section functions as error recovery for the failure modes (missing trigger registration, missing credentials, poison messages). It is not 5 because there is no explicit verification checkpoint (e.g., how to confirm a message was delivered/consumed after setup); it is not 3 because the sequence is complete with pitfalls covering the main failure paths.

4 / 5

Progressive Disclosure

No bundle files exist, and the ~140-line body is organized into well-labeled sections (What It Is, Quickstart, Send Options, Consumer Options, Other Runtimes, Errors, Common Pitfalls, References) with clearly signaled external doc links in the References section. This matches the 4 anchor ('good structure; most content appropriately placed; references mostly clear'). It falls short of 5 because reference-like material (e.g., Other Runtimes and Frameworks details) is inlined with no one-level-deep reference files to split into, though the size does not yet demand it.

4 / 5

Total

17

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: concrete capability list, both JS and Python SDK names, an explicit 'Use when...' clause with natural trigger phrases, and explicit handling of the Queues-vs-Workflows boundary. The only weakness is missing a few common synonyms (message queue, background jobs) that users might naturally say.

DimensionReasoningScore

Specificity

The description enumerates concrete capabilities — "durable topics with at-least-once delivery, independent consumer groups, retries, delays, and idempotency keys" — and names both SDKs ("@vercel/queue (JS) or vercel-queue (Python)"). It lists several specific features with only minor gaps (actions are implied by feature nouns rather than explicit verbs like publish/consume), sitting between the 'several specific actions' (4) and 'comprehensive concrete actions' (5) anchors, closer to 4.

4 / 5

Completeness

It explicitly answers both questions: the "what" ("durable topics with at-least-once delivery, independent consumer groups, retries, delays, and idempotency keys via @vercel/queue (JS) or vercel-queue (Python)") and an explicit "when" clause with concrete triggers ("Use when deferring background work, buffering traffic, fanning out events, or choosing between Queues and Workflows"). This matches the 5 anchor exactly; it is not the 4 anchor because the when-clause is explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Natural user phrases are present — "deferring background work", "buffering traffic", "fanning out events" — plus package-name triggers. However, common variations users would say such as "message queue", "job queue", or "background jobs" are missing, matching the 'good keyword coverage; a few natural terms missing' (4) anchor rather than the comprehensive synonym coverage of 5.

4 / 5

Distinctiveness Conflict Risk

It occupies a clear niche ("Vercel Queues guidance") with distinct product-specific triggers, and even pre-empts the nearest overlap by including "choosing between Queues and Workflows" as a trigger. Minimal conflict risk with other skills; matches the 5 anchor ('clear niche with distinct triggers').

5 / 5

Total

18

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository

vercel/vercel-plugin

Path

skills/queues/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.