CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

deployments-cicd

Vercel deployment and CI/CD expert guidance. Use when deploying, promoting, rolling back, inspecting deployments, building with --prebuilt, or configuring CI workflow files for Vercel.

Quality

90%

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

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

An excellent action-oriented skill body: executable commands and complete CI YAML throughout, workflows with explicit test-gated promotion and guarded destructive operations, and a clean overview-to-references split where all four referenced files exist and are one level deep. The only notable improvement is trimming the role-play opener and the pre-scripted response templates to save tokens.

DimensionReasoningScore

Conciseness

The body is dense with commands, YAML, and decision tables with almost no re-teaching of concepts Claude already knows; only minor parts could be trimmed (the "You are an expert in..." opener and the scripted canned-message templates in 'Deploy Next Steps'). This sits at anchor 4 — efficient with minor over-explanation — rather than anchor 5, since a few sections are padding rather than earned tokens.

4 / 5

Actionability

Every section gives copy-paste-ready material: complete bash command blocks, a full GitHub Actions workflow, exact required env vars (VERCEL_TOKEN/ORG_ID/PROJECT_ID), flag and build-error/fix tables, and a fully-specified stage→test→promote YAML. This matches anchor 5's fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

Multi-step workflows are explicitly sequenced with validation gates: `vercel pull` → `vercel build --prod` → `vercel deploy --prebuilt --prod`, and the release workflow's `needs: [stage, e2e-tests]` makes testing an explicit checkpoint before `vercel promote`. Feedback paths are present (Common Build Errors table; test failure blocks promote), and destructive operations are guarded ("ask the user, then run `vercel remove <id> --yes`"). Anchor 5 applies; validation is explicit, not merely implied as at anchor 4.

5 / 5

Progressive Disclosure

SKILL.md is a well-organized overview (core commands, CI setup, patterns, best practices) that cleanly splits specialized topics into four real one-level-deep files (deployment-checks.md, cli-pipelines.md, oidc-federation.md, live-status.md), each clearly signaled via a task-oriented 'Task | Read' table. No nested references and no content that should be extracted still inlined, matching anchor 5.

5 / 5

Total

19

/

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 with an explicit 'Use when' clause enumerating concrete Vercel-specific actions, giving excellent completeness and distinctiveness. The main weaknesses are a slightly generic 'what' statement ('expert guidance') and trigger coverage that omits natural synonyms and file-based triggers like 'preview', 'GitHub Actions', or vercel.json.

Suggestions

Replace the vague 'expert guidance' framing with concrete verbs, e.g. 'Deploys, promotes, rolls back, and inspects Vercel deployments...'.

Add commonly-spoken trigger terms such as 'preview deployments', 'GitHub Actions', 'GitLab CI', or 'vercel.json' to the 'Use when' clause to widen natural-match coverage.

DimensionReasoningScore

Specificity

"deploying, promoting, rolling back, inspecting deployments, building with --prebuilt, or configuring CI workflow files" lists several specific actions, but the what-clause "Vercel deployment and CI/CD expert guidance" is generic and minor actions (logs, env vars, previews) are absent. It clearly exceeds anchor 3 (more than 1-2 concrete actions) but falls short of anchor 5's comprehensive coverage.

4 / 5

Completeness

The 'what' is clearly stated ("Vercel deployment and CI/CD expert guidance") and the 'when' is explicit with concrete trigger phrases: "Use when deploying, promoting, rolling back, inspecting deployments, building with --prebuilt, or configuring CI workflow files for Vercel." This matches anchor 5; it exceeds anchor 4 because the when-clause is fully explicit rather than merely present.

5 / 5

Trigger Term Quality

Natural user verbs are present ("deploying", "rolling back", "promoting", "building with --prebuilt"), giving good keyword coverage, but common variations users would say — "preview", "GitHub Actions", "CI/CD setup", file triggers like `vercel.json` or `.github/workflows` — are missing from the description itself. Good coverage with a few natural terms missing matches anchor 4 rather than anchor 5's comprehensive synonym/extension coverage.

4 / 5

Distinctiveness Conflict Risk

"for Vercel" plus command-specific triggers (--prebuilt, promoting, rolling back) carve a clear niche with minimal overlap risk against generic CI/CD or platform skills. Anchor 5 fits; it is not a 4 because the triggers are platform-distinctive rather than merely mostly distinct.

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/deployments-cicd/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.