CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cron-jobs

Vercel Cron Jobs configuration and best practices. Use when adding, editing, or debugging scheduled tasks in vercel.json.

65

Quality

82%

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

86%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 concise, highly actionable reference skill: runnable config, a correct authorization code example, plan limits, and concrete debugging commands. The only real gap is the absence of an explicit deploy-and-verify workflow for newly added cron jobs, and a small amount of over-explanation of standard cron syntax.

DimensionReasoningScore

Conciseness

The body is lean and rule-driven ('Path must be an API route', 'Hobby plan limits — max 2 cron jobs') with almost no padding. It is not a 5 because it restates knowledge Claude already has ('Schedule uses standard cron syntax — five-field format: minute hour day-of-month month day-of-week'), which could be trimmed.

4 / 5

Actionability

Everything is copy-paste ready: a complete vercel.json crons block, an executable CRON_SECRET auth guard for app/api/cron/route.ts, concrete schedule examples for common cases, and the specific command 'vercel logs --follow'. Not 4 — there are no gaps; the common cases are covered with runnable code.

5 / 5

Workflow Clarity

A simple, single-purpose skill with clearly organized sections and verification guidance ('Check deployment logs', 'vercel logs --follow'), so it is near the simple-skill exception. It is not a 5 because no explicit add → deploy → verify sequence is given — the user must infer that a deploy is required before the cron takes effect.

4 / 5

Progressive Disclosure

The skill is ~57 lines, needs no external reference files (none exist in the bundle), and is organized into clear Configuration / Key Rules / Common Patterns / Debugging / References sections. Per the simple-skill exception, well-organized sections with no split needed score 5; the single external link is one level deep and clearly signaled.

5 / 5

Total

18

/

20

Passed

Description

73%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, well-scoped description with an explicit and specific 'Use when' clause anchored to vercel.json. The main weakness is the vague 'what' half — 'configuration and best practices' names no concrete capabilities, leaving it at anchor 3 for specificity.

Suggestions

Replace 'configuration and best practices' with concrete capability verbs, e.g. 'Add, edit, and debug cron job schedules (path + cron syntax) in vercel.json, including CRON_SECRET authorization checks and plan limit troubleshooting.'

Add natural synonyms to widen trigger coverage, e.g. 'recurring tasks', 'periodic jobs', or 'scheduled function invocations'.

Drop the filler phrase 'best practices' — it adds no trigger value and inflates the description without stating a capability.

DimensionReasoningScore

Specificity

The description names the domain ('Vercel Cron Jobs configuration and best practices') and implies concrete actions ('adding, editing, or debugging'), but the 'what' is generic — 'configuration and best practices' names no specific capabilities. This matches anchor 3 (names domain and 1-2 concrete actions, not comprehensive) rather than 4, which expects several specific listed actions.

3 / 5

Completeness

Both halves are explicit: what ('Vercel Cron Jobs configuration and best practices') and when ('Use when adding, editing, or debugging scheduled tasks in vercel.json'). It falls short of anchor 5 only because the 'what' is padded ('best practices') rather than enumerating concrete capabilities.

4 / 5

Trigger Term Quality

'Cron jobs', 'scheduled tasks', and 'vercel.json' are natural phrases a user would say, giving good keyword coverage. It is not a 5 because common variations such as 'recurring', 'periodic', 'scheduler', or 'cron schedule' are missing.

4 / 5

Distinctiveness Conflict Risk

'Vercel Cron Jobs' and 'vercel.json' pin a clear niche with distinct triggers, and 'scheduled tasks' is scoped to that context, so overlap with other skills is minimal. Not 4 because no closely related skill would plausibly trigger on these terms.

5 / 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/cron-jobs/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.