CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

create-a-backend

Backend architecture guidance. Use when planning, building, or migrating an API or backend; choosing between Functions, Services, containers, Daemons, Workflow, Queues, and Marketplace databases; or selecting a supported backend framework or runtime.

Quality

88%

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 strong router-style skill: a dense product map, concrete decision rules, named providers and frameworks, and a clear delegation path to focused skills. Minor improvements are trimming a few framing sentences and adding a fallback cue when multiple products seem to fit.

Suggestions

Trim positioning/framing sentences ('Vercel runs complex backend applications, not just frontends'; 'choose based on ecosystem and application needs').

Add a brief fallback cue in the work sequence for when multiple products seem to fit (e.g., re-check the product map or ask about release-cycle and durability needs).

DimensionReasoningScore

Conciseness

Mostly dense decision-bearing content (the need→product table, 'Choose Daemons only when a process must stay running to pull work'), but framing like 'Vercel runs complex backend applications, not just frontends' and 'For a new project, choose based on ecosystem and application needs' is trimmable. Fits 'efficient; minor instances of over-explanation that could be trimmed' rather than the 5 anchor where every token earns its place.

4 / 5

Actionability

Provides concrete, executable routing guidance: a need→product table with doc links, explicit rules ('Use Functions for the normal request/response backend', 'Use container images when the application already has a Dockerfile'), named providers (Neon, Supabase, Upstash, Turso), and a work sequence naming the exact follow-on skills to load (`vercel-functions`, `vercel-services`, `daemons`, `queues`). Specific guidance covers the common cases; per the rubric's code-vs-instruction note, absence of code is not penalized for a routing skill.

5 / 5

Workflow Clarity

The four-step work sequence (identify workloads → select products then framework → load focused skill → 'Confirm function limits, regions, environment variables, observability, and current product availability... before deployment') is clearly ordered with a pre-deploy confirmation checkpoint. Falls short of the 5 anchor because there are no feedback loops or criteria for revisiting a choice when products overlap — 'minor validation gaps', not missing checkpoints.

4 / 5

Progressive Disclosure

The body stays at overview altitude and delegates implementation through well-signaled, one-level-deep references: step 3 lists the focused skills by name, and 'load ⤳ skill:vercel-sandbox' / 'load ⤳ skill:offload-to-sandbox' are explicit pointers. No bundle files exist (references/, scripts/, assets/ are absent) and none are inlined, so nothing is buried; sections are clearly organized for navigation.

5 / 5

Total

18

/

20

Passed

Description

88%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 with a terse but clear 'what' and an explicit, detailed 'Use when' clause enumerating concrete trigger scenarios and product choices. The main gaps are a few missing colloquial trigger terms and the absence of the word 'Vercel', which leaves minor overlap risk with generic backend skills.

Suggestions

Include 'Vercel' explicitly in the description to eliminate overlap with generic backend-development skills.

Add natural user phrasings such as 'server', 'REST API', or 'deploy my backend' to the trigger coverage.

DimensionReasoningScore

Specificity

Enumerates multiple concrete actions — 'planning, building, or migrating an API or backend', 'choosing between Functions, Services, containers, Daemons, Workflow, Queues, and Marketplace databases', 'selecting a supported backend framework or runtime' — covering creation, migration, product selection, and framework selection. Not 4 because coverage of the domain's decision points is complete rather than having minor gaps; not lower because every clause names a specific action rather than abstract language.

5 / 5

Completeness

Explicitly answers 'what' ('Backend architecture guidance') and 'when' with concrete trigger phrases ('Use when planning, building, or migrating an API or backend; choosing between...; or selecting a supported backend framework or runtime'). The 'when' clause is richer than the 4 anchor's 'could be more explicit or specific', matching the 5 anchor's both-answered-with-concrete-triggers pattern.

5 / 5

Trigger Term Quality

Includes natural terms users would say — 'API', 'backend', 'framework', 'runtime', 'databases', 'containers', 'Queues', 'Workflow' — but misses common variations such as 'server', 'REST', 'endpoints', or 'deploy my backend'. Matches 'good keyword coverage; a few natural terms missing' rather than the comprehensive synonym coverage of the 5 anchor.

4 / 5

Distinctiveness Conflict Risk

Vercel-specific product names (Functions, Services, Daemons, Marketplace databases) establish a clear niche, but the description never says 'Vercel' and generic triggers like 'planning, building, or migrating an API or backend' could overlap with a general backend-development skill. Fits 'mostly distinct; minor overlap risk with closely related skills' rather than the 5 anchor's minimal conflict risk.

4 / 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/create-a-backend/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.