Agent skill · practicalswan
netlify-deploy
Create and manage Netlify deploys — Git continuous deployment, CLI manual/anonymous deploys, Deploy to Netlify buttons, drag-and-drop, and per-context netlify.toml build settings. Use when linking a repo, deploying from the CLI, setting up Deploy Previews or branch deploys, configuring deploy contexts, adding skew protection, fixing a failed or secrets-flagged deploy, or wiring build hooks and Deploy to Netlify buttons.
What it needs
About 8k tokens when loaded.
What this skill does
Netlify deploy Deploy context config (netlify.toml, current form) Configure per-context build settings in netlify.toml at the repo root. Five predefined contexts: production, deploy-preview, branch-deploy, preview-server, dev. Branch names also work as custom contexts (a staging branch matches a staging context). Precedence: site globals < context overrides; production overrides globals when building production; more specific contexts (a named branch) override general ones (branch-deploy). Only explicitly-set options are overridden. File-based config overrides UI settings. Footgun — secrets in netlify.toml: netlify.toml is committed to your repo. Do not put sensitive env values here, especially for public repos. Set secrets via the Netlify UI/CLI/API instead. Also: env vars declared in netlify.toml are NOT available to the deploy environment (Functions/Runtime/Post-processing scopes) — only UI/CLI/API-created vars are. CLI deploys Manual deploys do NOT run a build command (exception: Netlify Drop builds for you when logged in). Anonymous deploys create a temporary project claimable within one hour; on claim it adopts the team's default visibility. Footgun — link writes .netlify/state.json: every linking/create path writes .netlify/state.json. Add .netlify to .gitignore so it is never committed. Footgun — manual --prod on a Git-connected site: the next push to the production branch silently replaces your hand-shipped deploy. Warn the user before running it; if the deploy must stay live, lock the published deploy. Git continuous deployment Connect a Git repo (Git provider OAuth2 or the Netlify GitHub App). Netlify runs your build command and deploys on every push. Production deploys are triggered by pushes to the production branch (default main); Deploy Previews are built for pull/merge requests and agent runs. Deploy Previews & branch deploys Deploy Previews build by default for PRs/MRs and agent runs. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills practicalswan/netlify-deploy