CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

daemons

Vercel Daemons guidance — long-running background workers built from a Dockerfile and declared under the `daemons` key in vercel.json. Use when running queue consumers, Celery/Sidekiq/BullMQ workers, workflow workers, or job runners next to an app on Vercel; configuring daemon instances per region, memory, or command; handling SIGTERM; or choosing between Daemons, Functions, Queues, and Workflows.

72

Quality

91%

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

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 strong, dense reference skill: every section carries product-specific beta knowledge Claude would not otherwise have, with executable code for the main paths (declare, deploy, consume queues, shut down gracefully) and honest limits/pitfalls coverage. The main improvement levers are deduplicating the SIGTERM/grace-period details repeated across four sections and adding an explicit post-deploy verification step.

Suggestions

Consolidate the terminationGracePeriodSeconds/SIGTERM details that currently appear in the Configuration Reference, Graceful Shutdown, Limits, and Pitfalls sections into one authoritative location and cross-reference it from the others.

Add an explicit verification checkpoint after the Quick Start deploy step (e.g., "confirm the two instances appear under the dashboard Daemons tab or in Logs with source `daemon`").

Consider moving the Configuration Reference field table, naming rules, and limits/quota details into a one-level-deep references file (e.g., references/config.md), keeping SKILL.md as the overview.

DimensionReasoningScore

Conciseness

The body is dense and assumes Claude's competence (no explanation of Docker or basic concepts), with well-chosen tables for decision guidance, config fields, and limits. It falls short of a 5 because SIGTERM/grace-period details recur across the Configuration Reference, Graceful Shutdown, Limits, and Pitfalls sections, and SDK version guidance ("@vercel/oidc 4.0.0 or later") is embedded outside a deprecated/old-patterns section.

4 / 5

Actionability

Guidance is fully executable throughout: a complete Dockerfile, two full vercel.json examples (Node and Celery), runnable TypeScript and Python SIGTERM handling loops, a complete PollingQueueClient consumer example, and concrete docker build/run commands for local development. Code is copy-paste ready and covers the common cases (Node and Python workers).

5 / 5

Workflow Clarity

The Quick Start sequence (add Dockerfile → declare under `daemons` → deploy to production) is clear and unambiguous, and error-recovery guidance exists ("If a `vercel.json` change to `instances` seems ignored, check for an override first"; the dashboard Daemons tab for status; a pitfalls list for failure modes). It stops short of 5 because no explicit post-deploy verification checkpoint ties the deploy step to observing the running instances.

4 / 5

Progressive Disclosure

The single-file body is well organized with clear section headers, clearly signaled cross-skill references ("⤳ skill: queues", "⤳ skill: vercel-functions"), and a tidy external-docs reference list. However, ~217 lines are inlined in SKILL.md with no bundle split — the configuration reference and limits detail would also fit well in one-level-deep reference files.

4 / 5

Total

17

/

20

Passed

Description

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

The description is exemplary: it states concretely what the skill covers and gives an explicit, well-structured "Use when" clause enumerating the exact scenarios and technologies (Celery/Sidekiq/BullMQ, queue consumers, SIGTERM, regional instance config) a user would mention. It is in third-person voice with no fluff or over-claims.

DimensionReasoningScore

Specificity

The description names the domain ("long-running background workers built from a Dockerfile and declared under the `daemons` key in vercel.json") and lists multiple concrete actions: running queue consumers/Celery/Sidekiq/BullMQ/workflow workers, configuring instances per region, memory, or command, handling SIGTERM, and choosing between Daemons, Functions, Queues, and Workflows. Coverage is comprehensive with no noticeable gap, matching the anchor for multiple specific concrete actions.

5 / 5

Completeness

The "what" is explicit ("long-running background workers built from a Dockerfile and declared under the `daemons` key in vercel.json") and the "when" is explicit with concrete trigger phrases ("Use when running queue consumers... configuring daemon instances per region, memory, or command; handling SIGTERM; or choosing between Daemons, Functions, Queues, and Workflows"). Both halves are clearly and explicitly stated.

5 / 5

Trigger Term Quality

Natural user phrasing is comprehensively covered with synonyms: "queue consumers", "Celery/Sidekiq/BullMQ workers", "workflow workers", "job runners", "background workers", "SIGTERM", and the concrete artifact "vercel.json". These are exactly the terms a user would say when needing this skill, matching the anchor for comprehensive natural-term coverage including synonyms.

5 / 5

Distinctiveness Conflict Risk

The niche is tightly scoped to Vercel's platform-specific `daemons` feature with distinct triggers (vercel.json, per-region instances, named worker frameworks), and the "choosing between Daemons, Functions, Queues, and Workflows" trigger actively disambiguates against sibling skills. Minimal conflict risk with any other skill.

5 / 5

Total

20

/

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/daemons/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.