CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

add-vercel

Add Vercel deployment capability to NanoClaw agents. Installs the Vercel CLI in agent containers and sets up OneCLI credential injection for api.vercel.com. Use when the user wants agents to deploy web applications to Vercel.

Quality

89%

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

85%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 highly actionable, well-sequenced operational skill: executable commands at every step, explicit stop conditions, and validation including a structural test. The main weakness is organization of supporting material — referenced bundle files are missing from the skill directory and the complex attach/secret bash blocks are inlined rather than split into scripts, leaving progressive disclosure below the bar the rest of the content sets.

Suggestions

Ship the referenced bundle files with the skill (container-skills/vercel-cli/, vercel-manifest.test.ts) or remove/repair the paths so every referenced path resolves inside the skill directory.

Move the two large variable-fill bash blocks (secret creation and secret attach) into bundled scripts that take arguments, shortening SKILL.md to the decision logic and edit points.

Verify the /add-onecli dependency at pre-flight alongside the onecli version check, so the Phase 3 gateway check script path is validated before the user is asked for a token.

DimensionReasoningScore

Conciseness

The body is command-first with no explanation of concepts Claude already knows, and every prose passage carries non-obvious operational constraints (why the token goes in a file, why the manifest rejects ranges). A few Phase 3 paragraphs (the gateway-version caveat, the stale-directory cleanup explanation) run long and could be trimmed, matching anchor 4's 'minor instances of over-explanation' rather than anchor 5's lean-everywhere.

4 / 5

Actionability

Every phase gives copy-paste-ready executable commands — rsync, jq filters, a pinned manifest entry, a structural vitest — with edit points (D, VERCEL_GROUPS, VERCEL_SECRET) and failure messages clearly marked. This matches anchor 5's 'fully executable; copy-paste ready… covers the common cases', including the multi-token ambiguity branch.

5 / 5

Workflow Clarity

Phases 1–6 are clearly sequenced with explicit validation checkpoints: an idempotence pre-flight, verification commands after each mutation, hard-stop branches (ONECLI_MISSING, gateway-grants failure), a structural test (Phase 4b), and sync/restart steps. The destructive and batch operations (rm -rf trap, docker stop) all have validation or guarded handling, matching anchor 5's sequence-plus-feedback-loops pattern.

5 / 5

Progressive Disclosure

Section structure is clear and the full command reference is properly delegated ('the agent has the vercel-cli container skill loaded automatically'), but the body's referenced bundle files — .claude/skills/add-vercel/container-skills/, vercel-manifest.test.ts, and the /add-onecli check script — do not exist in this skill directory, and the two large variable-fill bash blocks are inlined where bundled scripts would fit. This matches anchor 3's 'references present but not clearly backed; content that should be separate is inline' better than anchor 4.

3 / 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 description: third-person voice, concrete actions, and an explicit 'Use when…' trigger clause covering a distinct, well-defined niche. The only weakness is that the action list slightly understates the skill's full scope (credential attach, image rebuild, group sync), leaving minor coverage gaps in specificity and trigger terms.

DimensionReasoningScore

Specificity

Names concrete actions — 'Installs the Vercel CLI in agent containers and sets up OneCLI credential injection for api.vercel.com' — with a specific target host. Falls just short of anchor 5 because the action list is not comprehensive: credential attach, image rebuild, and group sync steps are absent, matching anchor 4's 'several specific actions; minor gaps'.

4 / 5

Completeness

Explicitly answers both parts: what ('Installs the Vercel CLI in agent containers and sets up OneCLI credential injection') and when ('Use when the user wants agents to deploy web applications to Vercel') with a concrete trigger phrase. This matches anchor 5's 'clearly and explicitly answers both what AND when' and exceeds anchor 4, where the 'when' is only implicit or imprecise.

5 / 5

Trigger Term Quality

'Vercel', 'deploy', and 'deploy web applications to Vercel' are phrases users would naturally say, giving good keyword coverage. A few natural terms are missing (e.g., 'hosting', 'preview deployments'), so it fits anchor 4 rather than anchor 5's comprehensive synonym coverage; it is clearly above anchor 3's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

Clear niche — adding Vercel deployment to NanoClaw agent containers — with distinct triggers ('Vercel', 'deploy web applications to Vercel') that no generic skill would claim. Minimal conflict risk, matching anchor 5; anchor 4's 'minor overlap risk with closely related skills' does not apply since no sibling skill shares these triggers.

5 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

nanocoai/nanoclaw

Path

.claude/skills/add-vercel/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.