CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

domains

Search, register, connect, transfer, and renew domain names on Vercel using the CLI or Domains Registrar API. Use for domain availability and pricing, custom domains, DNS records, nameservers, ownership verification, and domain orders.

71

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Medium

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 operational content: executable commands, task tables, explicit approval gates and reconciliation loops for purchases and DNS changes, and zero filler. The only notable issues are inline version-pinned behavior (CLI 63.1.0+) and a body length that sits at the edge of what belongs in a single SKILL.md versus a reference file.

DimensionReasoningScore

Conciseness

The body is dense and lean — no concept explanations, no padding, every sentence carries operational detail — but it pins behavior to a specific version ("With Vercel CLI 63.1.0+" / "On older CLIs") inline rather than isolating version-dependent guidance in a deprecated/legacy section, which the rubric flags as time-sensitive. This is mitigated by the instruction to "Check `vercel domains --help`... against the installed version", keeping it above the midpoint but short of the every-token-perfect anchor.

4 / 5

Actionability

The curl search request is fully executable copy-paste (flags, headers, JSON body), CLI commands use concrete example values (`example.com`, `my-project`, `--scope my-team`), and task→command tables cover DNS records, registration, transfer, renewal, and auto-renew. It fits the score-5 anchor: executable commands covering the common cases, exceeding score 4 only by completeness of coverage, which it achieves.

5 / 5

Workflow Clarity

Sequences are explicit with validation checkpoints and error-recovery loops: quote via `--json` without `--amount` → human approval → charged run; "rerun `domains verify` and check DNS propagation and HTTPS"; "if the outcome is unknown, run `domains inspect` before retrying"; "If a submission times out, reconcile its order status before resubmitting a charge"; "Stop polling when completed or failed". Despite involving destructive/batch operations (charges, transfers, DNS writes), validation is present throughout, so no cap applies.

5 / 5

Progressive Disclosure

Four well-organized sections with clear headers, and field-level API detail is correctly delegated to the live OpenAPI schema and Registrar API reference rather than inlined. It is not a 5 because the ~90-line single-file body (above the under-50-lines simple-skill threshold) keeps some dense registrar edge-case material (punycode `languageCode`, contact verification windows, `expectedPrice` semantics) inline that could live in a reference file, and no bundle references exist to signal.

4 / 5

Total

18

/

20

Passed

Description

88%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 that explicitly states concrete capabilities, tooling, and a clear 'Use for' trigger clause with natural domain-management vocabulary. Only minor improvements are possible: adding a few colloquial trigger synonyms would sharpen it further.

DimensionReasoningScore

Specificity

The description lists five concrete actions ("Search, register, connect, transfer, and renew domain names") plus the exact tooling ("using the CLI or Domains Registrar API"), giving comprehensive coverage of the skill's operations. It matches the top anchor's pattern of multiple specific concrete actions rather than the score-4 anchor, which expects minor gaps in coverage.

5 / 5

Completeness

Both halves are explicit: the "what" is "Search, register, connect, transfer, and renew domain names on Vercel using the CLI or Domains Registrar API" and the "when" is a concrete "Use for..." clause enumerating trigger scenarios. This mirrors the rubric's score-5 example (clear what AND when with concrete trigger phrases), not score 4 where the 'when' is present but less specific.

5 / 5

Trigger Term Quality

Strong natural terms are present — "domain availability and pricing", "custom domains", "DNS records", "nameservers", "ownership verification", and "domain orders" — but common user phrasings like "buy a domain" or "domain search" are absent. This fits the score-4 anchor (good coverage, a few natural terms missing) rather than the score-5 anchor requiring synonyms and comprehensive variations.

4 / 5

Distinctiveness Conflict Risk

The description is tightly scoped to "domain names on Vercel" via CLI/Registrar API, making it mostly distinct. It is not a 5 because triggers like "DNS records" and "nameservers" carry minor overlap risk with a hypothetical generic DNS-management skill. It clearly exceeds the score-3 anchor ('could still overlap with similar skills') because the Vercel and registrar framing pins the niche.

4 / 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/domains/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.