CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

netlify-deploy

Create, configure, and manage Netlify deploys from code — reach for this when setting up Git continuous deployment, running netlify deploy or netlify deploy --prod from the CLI, writing netlify.toml deploy contexts, adding a Deploy to Netlify button, wiring build hooks, configuring Deploy Previews or branch deploys, locking or skipping deploys, fixing a failed or secrets-scanning deploy, or when someone asks to "deploy my site", "set up preview deploys", "add per-branch build config", "keep staging out of Google", or "add a deploy button to my README".

Quality

93%

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

The canonical home for this skill is netlify-deploy in netlify/context-and-tools

SKILL.md
Quality
Evals
Security

Quality

Content

82%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 strong operational reference: nearly every line is non-obvious Netlify-specific behavior, guidance is executable with exact commands, TOML, URLs, and UI paths, and deep material is correctly pushed to three well-signaled reference files. The main deductions are duplicated content from the appended house-rules section and detail-heavy sections (deploy button variants, netlify.toml example) that could live in references, plus the absence of explicit validate-then-proceed checkpoints for risky flows.

Suggestions

Remove or de-duplicate the appended 'Netlify house rules' section — its nine rules restate warnings already present in the body (no rollbacks, .gitignore, secrets scanning, manual --prod), costing ~40 lines of pure duplication.

Move the Deploy-to-Netlify URL parameter variants and [template] config block into a reference file (or the existing netlify-toml reference), keeping only the basic button snippet inline.

For risky flows, add explicit validate-then-proceed steps (e.g., after linking a site, verify .gitignore contains .netlify before the first deploy; before netlify deploy --prod on a Git-CD site, confirm the lock state).

DimensionReasoningScore

Conciseness

The body is dense with Netlify-specific, non-obvious facts (atomic deploys, 54,000-files-per-directory limit, skew-protection caveats, noindex behavior) and explains nothing Claude already knows, matching 'efficient' more than 'verbose'. It falls short of a 5 because of duplication and meta-padding: the appended house-rules section restates body content almost line-for-line, and phrases like "State this limitation explicitly rather than leaving it implied" are commentary rather than instruction.

4 / 5

Actionability

Guidance is copy-paste ready throughout: runnable CLI commands (`netlify deploy --prod`, `npm update -g netlify-cli`), a complete executable netlify.toml context example, a working Deploy-to-Netlify markdown snippet with concrete URL parameter variants, exact UI paths ("Deploys list > Lock to stop auto publishing"), and precise skip markers (`[skip ci]` in PR title vs. commit message). This matches the score-5 anchor: fully executable examples covering the common cases.

5 / 5

Workflow Clarity

Each task area gives concrete, correctly-ordered decision guidance with explicit warnings before risky actions (⚠ manual --prod on a Git-CD site, ⚠ deletion is permanent, ⚠ secrets scanning), and failure handling is spelled out (failed deploy never publishes; fix forward via revert). It sits at 4 rather than 5 because the skill is organized as a topic reference rather than sequenced workflows — there are no explicit validate-then-proceed checkpoints for tasks like linking a site or shipping a manual production deploy.

4 / 5

Progressive Disclosure

Structure is good: a ~190-line overview with three real, one-level-deep, clearly signaled references (`references/netlify-toml.md` for precedence rules, `references/deployment-patterns.md` for context strategy, `references/cli-commands.md` for the full CLI surface), all verified to exist. It does not reach 5 because the overview itself carries substantial detail that could be split out (full deploy-button URL variants and [template] config, the complete netlify.toml example), and the trailing merged house-rules block duplicates in-file content.

4 / 5

Total

17

/

20

Passed

Description

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

An exemplary description: it states concrete capabilities in third person, provides an explicit 'reach for this when' trigger clause, and includes both technical keywords and verbatim natural-language user requests. Coverage is comprehensive and squarely within the Netlify-deploy niche, with no over-claims or fluff.

DimensionReasoningScore

Specificity

The description enumerates many concrete actions — "setting up Git continuous deployment", "running netlify deploy or netlify deploy --prod", "writing netlify.toml deploy contexts", "adding a Deploy to Netlify button", "wiring build hooks", "locking or skipping deploys", "fixing a failed or secrets-scanning deploy" — covering the skill's scope comprehensively in third-person voice. This matches the score-5 anchor (multiple specific concrete actions, comprehensive coverage) rather than 4, which allows minor gaps in coverage.

5 / 5

Completeness

Both halves are explicit: the 'what' is "Create, configure, and manage Netlify deploys from code" and the 'when' is the explicit "reach for this when..." clause followed by a long list of concrete trigger conditions and quoted user requests. This matches the score-5 anchor exactly; a 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

It pairs technical keywords (netlify deploy, netlify.toml, build hooks, Deploy Previews, branch deploys) with natural user phrasings quoted directly: "deploy my site", "set up preview deploys", "add per-branch build config", "keep staging out of Google", "add a deploy button to my README". This is comprehensive natural-term coverage including synonym-style variations, matching the score-5 anchor; nothing common is obviously missing.

5 / 5

Distinctiveness Conflict Risk

The description is anchored to a clear niche (Netlify deploys) with product-specific triggers — netlify CLI, netlify.toml, Deploy to Netlify button, Deploy Previews — that no other skill would claim. Conflict risk with adjacent skills (e.g., general CI/CD or config skills) is minimal because every trigger term is Netlify-branded or deploy-specific.

5 / 5

Total

20

/

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

netlify/context-and-tools

Path

agent-plugin/skills/netlify-deploy/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.