CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

vercel-queues

Vercel Queues guidance (public beta) — durable event streaming with topics, consumer groups, retries, and delayed delivery. $0.60/1M ops. Powers Workflow DevKit. Use when building async processing, fan-out patterns, or event-driven architectures.

64

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/vercel/skills/vercel-queues/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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.

Strong body content for a brand-new beta API: copy-paste-executable code for every major operation, sharp when-to-use/when-not-to-use routing, and lean tables instead of prose. Its main structural weakness is that everything lives in one SKILL.md — no reference files split out the API details, limits, and observability material — and some time-sensitive pricing/date detail is inline rather than isolated.

Suggestions

Move the detailed reference material (Transports table, Key Limits, Poll-Mode consumer, Custom Region Client, Observability metrics) into a references/ file (e.g., references/api.md) and keep SKILL.md as a concise overview with clearly signaled one-level-deep links.

Isolate time-sensitive facts (public beta date, $0.60/1M ops pricing, @vercel/queue@^0.1.3 version pin) into a dedicated Status/Pricing section marked as version-sensitive so they can be updated without re-reading the whole body, and trim them from the core coding guidance.

Add an explicit post-deploy validation step tying the Observability 'Max message age' metric to consumer-lag detection, so the workflow ends in a verify-checkpoint loop rather than just describing the dashboard.

DimensionReasoningScore

Conciseness

The body is dense and factual — tables and copy-paste code with almost no explanation of concepts Claude already knows — matching anchor 4's 'efficient; minor instances that could be trimmed'. The pricing/date details ("$0.60 per 1M operations", "public beta on February 27, 2026") are time-sensitive facts placed inline rather than in a versioned/deprecated section, and sections like Observability and Transports add length beyond the core coding task, keeping it below anchor 5.

4 / 5

Actionability

Every section gives fully executable, copy-paste-ready TypeScript: `send('order-events', {...}, { delaySeconds, idempotencyKey, ... })`, a complete `handleCallback` consumer with retry policy, the `vercel.json` `experimentalTriggers` config, and the poll-mode `receive()` call — covering the common cases (publish, push consume, poll consume, region pinning). The opening instruction to fetch https://vercel.com/docs/queues before coding is itself a concrete, actionable guard for an API absent from training data, matching anchor 5.

5 / 5

Workflow Clarity

As a reference skill it has no multi-step sequence to validate, but the decision routing is clear: the 'Queues vs Workflow vs Cron' table tells the reader exactly when to use each primitive, the 'When NOT to Use' section lists hazards ("messages sent to one region cannot be consumed from another"), and the retry example embeds a failure-handling checkpoint ("if (metadata.deliveryCount > 5) return { acknowledge: true }"). It is not a 5 because there is no explicit end-to-end workflow with validation checkpoints (e.g., verify consumer lag via Max message age after deploying) — the observability signal is described but not wired into a step.

4 / 5

Progressive Disclosure

The body is well-sectioned with clear headers, but it is a ~195-line monolith with no bundle files at all (no references/, scripts/, or assets/ exist) — the Transports table, Key Limits, Poll-Mode, Observability, and Local Development sections are all inline API-reference material that clearly belongs in one-level-deep reference files. This matches anchor 3's 'Some structure... content that should be separate is inline' rather than anchor 4, which expects the bulk of detailed material split out with clearly signaled references.

3 / 5

Total

16

/

20

Passed

Description

75%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 solid, well-formed description: it states what Vercel Queues is, gives an explicit 'Use when...' trigger clause, and stays in the concise third-person pattern. It consistently lands at anchor 4 across dimensions — specific but not exhaustive on capabilities, good but not comprehensive on trigger synonyms, and with minor overlap risk against generic async/Workflow skills.

DimensionReasoningScore

Specificity

Names the domain ("Vercel Queues guidance (public beta) — durable event streaming") and lists several concrete capabilities ("topics, consumer groups, retries, and delayed delivery"), which matches anchor 4's 'several specific actions; minor gaps'. It scores 4 rather than 5 because the skill's own action is only the vague word "guidance" — the enumerated items describe the product's features, not what the skill concretely does (e.g., write consumers, configure vercel.json triggers).

4 / 5

Completeness

Both halves are present: the "what" ("durable event streaming with topics, consumer groups, retries, and delayed delivery. Powers Workflow DevKit.") and an explicit "Use when building async processing, fan-out patterns, or event-driven architectures." It falls short of anchor 5 only because the trigger phrases are broad patterns rather than concrete user mentions (e.g., 'when the user mentions message queues or background jobs'), and "$0.60/1M ops" pricing adds neither what nor when.

4 / 5

Trigger Term Quality

The "Use when building async processing, fan-out patterns, or event-driven architectures" clause covers natural user phrasings, plus terms like "queues", "retries", and "durable event streaming". It is not a 5 because common synonyms a user would actually say — "message queue", "background jobs", "task queue", "event streaming" variations — are missing, matching anchor 4's 'good keyword coverage; a few natural terms missing'.

4 / 5

Distinctiveness Conflict Risk

"Vercel Queues" carves a clear niche with distinct triggers, matching anchor 4. Minor overlap risk remains: "Powers Workflow DevKit" invites triggering on general Workflow questions, and "async processing" / "event-driven architectures" are broad enough to collide with generic background-job or pub/sub skills, keeping it below anchor 5.

4 / 5

Total

16

/

20

Passed

Validation

87%

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

Validation — 14 / 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

Total

14

/

16

Passed

Repository

openai/plugins

Path

plugins/vercel/skills/vercel-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.