netlify-deploy

Automates end-to-end Netlify deployments via CLI with authentication and site linking/creation.

32|7|Updated Nov 26, 2025
One-click install
npx skills add https://github.com/netlify/context-and-tools --skill netlify-deploy-netlify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: netlify-deploy
Source: https://github.com/netlify/context-and-tools/tree/main/codex/skills/netlify-deploy
Command: npx skills add https://github.com/netlify/context-and-tools --skill netlify-deploy-netlify

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Deployments to Netlify can be error-prone and manual; this skill automates the end-to-end deployment workflow using the Netlify CLI, handling authentication, site linking or creation, and environment context.

Core Features & Use Cases

  • Pre-authentication checks and guided login
  • Detects project configuration and links to existing Netlify sites or creates new ones
  • Supports preview and production deployment flows, including netlify.toml guidance
  • Reports deployment results with URLs and logs for quick validation

Quick Start

Deploy your current project to Netlify in preview mode first, then promote to production after review.

Frequently Asked Questions about netlify-deploy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Netlify deployments from the CLI?

Automating Netlify deployments involves using the CLI to handle pre-authentication checks, link or create a site, and execute preview and production deploys with status reporting. This skill manages that entire workflow end-to-end.

What's the best way to deploy a project to Netlify in preview mode before production?

Deploying in preview mode first is recommended to validate changes before promoting to production. This approach uses the CLI to run a preview deployment, reports the resulting URL, and allows promotion after review.

Does Netlify CLI deployment require setting up a netlify.toml file?

Setting up a netlify.toml file is supported as part of the deployment configuration for build and publish settings. The skill detects project configuration and provides guidance for establishing these environment contexts.

How does authentication work when deploying to Netlify via the CLI?

Authentication for Netlify CLI deployments is handled through guided login and pre-authentication checks. The skill automates this state verification to ensure secure access before linking sites or executing deployment commands.

Can I link an existing project to a Netlify site instead of creating a new one?

Linking an existing project is supported through Git-based linking mechanisms. The skill detects your project configuration and connects it to an existing Netlify site, or interactively creates a new one if no match is found.

Why are my manual Netlify deployments failing during the build and publish process?

Manual Netlify deployments often fail due to misconfigured build and publish settings or missing authentication state. Automating the workflow via CLI ensures proper site linking, environment context, and status reporting to prevent errors.