CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

bootstrap

Project bootstrapping orchestrator for repos that depend on Vercel-linked resources (databases, auth, and managed integrations). Use when setting up or repairing a repository so linking, environment provisioning, env pulls, and first-run db/dev commands happen in the correct safe order.

Quality

85%

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

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

This is a high-quality operational skill: a strictly ordered, validation-gated bootstrap workflow with copy-paste commands, secret-safe handling, fallback paths, a verification checklist, and error-recovery loops. The remaining gaps are minor — two under-specified steps (Neon CLI fallback, Geist font fix), a small intro/Rules redundancy, and specialized variant guidance (next-forge, shadcn baseline) that could live in separate reference files.

Suggestions

Make 'Fallback path 2 (Neon CLI)' concrete: list the actual Neon CLI commands to create the database and add env vars in Vercel, mirroring the specificity of the preferred path.

Specify the Geist font fix (the exact font declarations/imports for layout.tsx and globals.css) instead of naming it, since 'apply the fix' is not executable as written.

Move the next-forge section and the shadcn UI Baseline into clearly signaled one-level-deep reference files (e.g., next-forge.md, ui-baseline.md) so the core bootstrap workflow in SKILL.md stays lean.

DimensionReasoningScore

Conciseness

The body is lean and command-first — nearly every section is executable bash with terse, operational rationale (e.g., '# separate command: development-only adds default to Config') and zero explanation of concepts Claude already knows. It falls just short of anchor 5 due to minor trimmable redundancy: the opening line ('Do not run migrations or development server until project linking and environment verification are complete') restates the Rules section almost verbatim.

4 / 5

Actionability

Most guidance is copy-paste ready: exact vercel CLI invocations ('vercel link --yes --scope <team> --project <project>'), a fully executable env-diff bash snippet, a safe AUTH_SECRET generation pipeline, and explicit fallback paths. Two spots keep it below anchor 5: 'Fallback path 2 (Neon CLI)' says to use the Neon CLI without giving its commands, and 'Apply the Geist font fix in layout.tsx and globals.css' names a fix without specifying what it is.

4 / 5

Workflow Clarity

The sequence is explicit and strictly gated — Preflight → Resource Setup → AUTH_SECRET → Env Verification ('Proceed only when missing key list is empty') → App Setup → a Bootstrap Verification checklist — with the destructive db commands blocked until linking and env keys are verified. Error-recovery feedback loops are present ('If verification fails, stop and report exact failing step plus remediation'; 're-run only the failed db step'; restart guidance for dev failures), matching the anchor-5 pattern including the required validation for database operations.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent), so everything is inline in a single ~175-line file. Section headers are clear and well-ordered, and the Prisma variant properly defers pooled-connection detail to the 'vercel-storage' skill rather than duplicating it. It sits at anchor 4 rather than 5 because specialized variant content (the next-forge section, the shadcn/UI Baseline section) is inlined in the main workflow instead of being split into clearly signaled one-level-deep reference files.

4 / 5

Total

17

/

20

Passed

Description

87%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: it states what the skill orchestrates, gives an explicit 'Use when' trigger with concrete operational phrases, and occupies a distinct Vercel-bootstrap niche. Its only weakness is mild abstraction — it compresses the operation list instead of enumerating every concrete action, and a few natural user synonyms are absent.

DimensionReasoningScore

Specificity

The description names the domain ('repos that depend on Vercel-linked resources (databases, auth, and managed integrations)') and several concrete actions: 'linking, environment provisioning, env pulls, and first-run db/dev commands'. It stops short of anchor 5's comprehensiveness because it summarizes the operations rather than enumerating the full set (e.g., secret generation, verification, multi-variant setup paths) and stays at a slightly abstract 'orchestrator' level.

4 / 5

Completeness

Both parts are explicit: the 'what' ('Project bootstrapping orchestrator for repos that depend on Vercel-linked resources... linking, environment provisioning, env pulls, and first-run db/dev commands') and a concrete 'when' clause ('Use when setting up or repairing a repository so [these] happen in the correct safe order'). This matches the anchor-5 pattern of a clear what plus explicit trigger phrasing, and exceeds anchor 4 where the 'when' is only loosely specified.

5 / 5

Trigger Term Quality

It includes natural phrases a user would say — 'setting up or repairing a repository', 'linking', 'env pulls', 'first-run db/dev commands' — giving good keyword coverage. A few natural synonyms are missing (e.g., 'initialize', 'scaffold', 'get started', 'database setup'), and phrases like 'managed integrations' and 'environment provisioning' lean technical, so it does not reach anchor 5.

4 / 5

Distinctiveness Conflict Risk

The niche is clearly carved out — bootstrapping repos that depend on Vercel-linked resources with an ordering constraint ('correct safe order') — and the trigger terms (Vercel linking, env pulls, db/dev first run) are distinct from generic setup or deployment skills. It is in third person with no over-claim, fitting anchor 5's 'clear niche with distinct triggers; minimal conflict risk'.

5 / 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/bootstrap/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.