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.

73

Quality

92%

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.

Highly effective content: executable commands and workflows dominate, risky production releases are explicitly gated behind testing, and details are cleanly offloaded to real one-level-deep reference files. The only weakness is minor — a handful of sentences that over-explain what Claude can infer.

DimensionReasoningScore

Conciseness

The body is lean and command-first — code blocks with terse comments, tables for errors/strategies/flags, no tutorial padding about concepts Claude already knows. A few sentences could still be trimmed (e.g. 'They provide a unique URL for testing', 'Never commit them to source control'), placing it at the 4 anchor ('efficient; minor instances of over-explanation') rather than the 5 anchor's every-token-earns-its-place standard.

4 / 5

Actionability

Fully executable throughout: concrete CLI commands for every operation, a complete copy-paste GitHub Actions workflow, and a complete stage → e2e → promote pipeline in YAML (its elided '# ... checkout, install ...' steps duplicate the earlier full example, a justified omission). Error tables give specific fixes. Matches the 5 anchor ('fully executable; copy-paste ready; covers the common cases').

5 / 5

Workflow Clarity

Multi-step processes are clearly sequenced with explicit validation gates: the release workflow stages a production build ('vercel deploy --prod --skip-domain'), validates it (e2e-tests job gated on the staged URL), and only then promotes — a real validate-then-release checkpoint. The build-error table provides error-recovery feedback. Matches the 5 anchor ('clear sequence with explicit validation steps; feedback loops for error recovery').

5 / 5

Progressive Disclosure

The SKILL.md keeps core commands inline and splits detail one level deep into four reference files (cli-pipelines.md, oidc-federation.md, deployment-checks.md, live-status.md), all of which exist in the bundle and are surfaced via a task→file routing table ('Post preview URLs... | references/cli-pipelines.md'). Clear overview, well-signaled navigation, appropriate split — the 5 anchor.

5 / 5

Total

19

/

20

Passed

Description

92%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: it names a distinct Vercel deployment/CI-CD niche, lists concrete actions comprehensively, and provides an explicit 'Use when' trigger clause. The only gap is a few missing natural synonyms (GitHub Actions, GitLab CI, vercel.json) that would make trigger coverage fully comprehensive.

Suggestions

Add a few natural trigger synonyms users actually say, such as 'GitHub Actions', 'GitLab CI', or 'vercel.json / .github/workflows files', to lift trigger-term coverage from good to comprehensive.

Consider mentioning 'release pipeline' or 'CI setup' as phrasing variants, since 'configuring CI workflow files' may not match how users phrase the request.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — 'deploying, promoting, rolling back, inspecting deployments, building with --prebuilt, or configuring CI workflow files' — comprehensively covering the deployment lifecycle. It matches the score-5 anchor ('multiple specific concrete actions; comprehensive coverage') rather than 4, since no meaningful capability of the skill is left unlisted.

5 / 5

Completeness

It explicitly answers both what ('Vercel deployment and CI/CD expert guidance' plus concrete actions) and when ('Use when deploying, promoting, rolling back, inspecting deployments, building with --prebuilt, or configuring CI workflow files for Vercel'). This clearly matches the 5 anchor with concrete trigger phrases; it is not the 4 anchor because the 'when' clause is already fully explicit and specific.

5 / 5

Trigger Term Quality

Good natural keyword coverage ('deploying', 'rolling back', 'CI workflow files', 'Vercel'), but a few natural terms users would say are missing — e.g. 'GitHub Actions', 'GitLab CI', 'release pipeline', or file triggers like 'vercel.json' or '.github/workflows'. This lands on the 4 anchor ('good keyword coverage; a few natural terms missing') rather than 5 ('comprehensive... including synonyms and file extensions').

4 / 5

Distinctiveness Conflict Risk

A clear niche ('for Vercel') with distinct command-level triggers (deploy, promote, rollback, --prebuilt) that are unlikely to fire for unrelated skills. It matches the 5 anchor ('clear niche with distinct triggers; minimal conflict risk').

5 / 5

Total

19

/

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.