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.

64

Quality

81%

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

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.

A lean, well-structured routing skill: it maps concrete needs to specific Vercel products, scopes database and framework choices, and ends with a clear four-step work sequence that hands off to focused skills. The only soft spots are minor vague phrases ('with additional configuration as needed') and the absence of any recovery guidance around the pre-deployment checks.

DimensionReasoningScore

Conciseness

The body is dense and decision-oriented — a need→product table, framework lists, and a four-step sequence — with no explanation of concepts Claude already knows. Minor positioning fluff ('Vercel runs complex backend applications, not just frontends', 'first-class') keeps it from the lean-every-token-earns-its-place anchor.

4 / 5

Actionability

As an instruction-only skill the guidance is concrete and executable: the product map names a specific product per need with links, frameworks are enumerated by language, and the work sequence names the exact follow-up skills to load. 'with additional configuration as needed' and 'Confirm function limits... in the official docs' are vague spots that leave minor gaps.

4 / 5

Workflow Clarity

The 'Work sequence' section gives a clear ordered process (identify workload characteristics → select products then framework → load the focused skill → confirm limits before deployment), with step 4 acting as a pre-deployment checkpoint. It lacks any feedback or recovery guidance (what to do when a check fails), so it does not reach the explicit-validation anchor.

4 / 5

Progressive Disclosure

A ~58-line overview skill with no bundle files; content appropriately lives inline in well-organized sections (product map, databases, frameworks, work sequence), external doc links are one level deep and clearly signaled, and implementation detail is delegated to named sibling skills — matching the simple-skill exception for well-organized single-file content.

5 / 5

Total

17

/

20

Passed

Description

80%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 well-constructed description with an explicit, multi-clause 'Use when...' trigger and several concrete capability areas. Its main weakness is distinctiveness: the platform is unnamed and the trigger surface ('planning, building, or migrating an API or backend') is broad enough to collide with generic backend skills.

Suggestions

Name the platform explicitly (e.g., 'Use when planning, building, or migrating an API or backend on Vercel...') so the description cannot collide with generic backend-development skills.

Brand the product terms (e.g., 'Vercel Functions, Vercel Services, Vercel Queues') so they read as distinct product triggers rather than generic computing nouns.

Add one or two natural synonym triggers users commonly say, such as 'deploy a backend' or 'server-side API', to round out trigger coverage.

DimensionReasoningScore

Specificity

Enumerates several 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' — with only minor gaps. The core capability phrase 'Backend architecture guidance' is itself generic, keeping it below the comprehensive anchor.

4 / 5

Completeness

Explicitly answers both: what ('Backend architecture guidance' over the enumerated product and framework decision areas) and when — a fully explicit, multi-clause 'Use when planning, building, or migrating... choosing between... or selecting...' with concrete trigger phrases, matching the top anchor's pattern.

5 / 5

Trigger Term Quality

Contains natural phrases users would say — 'build a backend', 'backend architecture', 'migrating an API', 'backend framework or runtime' — plus product-category keywords. A few natural synonyms ('deploy a backend', 'server-side', 'REST API') are missing, so it falls just short of comprehensive coverage.

4 / 5

Distinctiveness Conflict Risk

The trigger 'planning, building, or migrating an API or backend' is broad and the platform (Vercel) is never named, so 'Functions, Services, Queues' could read as generic computing terms and the skill could overlap with any general backend-development skill. Only 'Marketplace databases' and the specific product enumeration give it a partial niche, so it does not reach 'mostly distinct'.

3 / 5

Total

16

/

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.