Skip to content
DevOps

Netlify Deploy

Prepare a Netlify CLI deployment and distinguish a review URL from the site's production destination.

Install with Skills CLI
npx skills add openai/skills@netlify-deploy

What it does

A build can succeed locally while a deployment serves an empty directory or updates the wrong site. Netlify Deploy checks account and site linkage before choosing how to publish the build.

What changes after install

  • Identify the account and site linked to the working directory.
  • Read build and publish settings from project configuration.
  • Report the URL for the requested deployment type.

Install

Run this command with Node.js 22.20 or later and select your agent in the Skills CLI.

Install with Skills CLI
npx skills add openai/skills@netlify-deploy

Before using Netlify Deploy

  • A buildable web project, Node.js with npx, Netlify access and an authenticated CLI session.

Read the reviewed setup instructions for the selected workflow.

When to use it

  • Create a draft URL for a site review.
  • Publish an approved build to a known Netlify site.

When not to use it

  • Deploying a project whose target host or account is undecided.

A worked example

For a documentation site, give the agent the repository, intended site name and a request for a draft only. Confirm the linked site before building. Open a nested documentation route on the returned draft URL to catch a wrong publish directory or missing route rule.

Troubleshooting

  • If authentication fails, check the CLI session.
  • If the wrong team appears, resolve site linkage before uploading.
  • If the deploy succeeds but the page is empty, compare the configured publish directory with the generated files.

How it chooses an approach

Use an existing site when the repository already belongs to it. For a new site, establish the intended owner and destination before creating resources. Specify draft or production explicitly.

When to use another skill

What to check after it runs

Compare the returned site name with the request. Inspect the draft or production URL as appropriate and load an asset as well as the homepage.

More in DevOps

Related skills in other categories

FAQ

Can I get a review URL for an existing site?
Yes. The documented draft deployment produces a URL that can be reviewed before a production rollout.
Do I need to install a global CLI first?
The upstream instructions invoke the Netlify CLI through npx. The environment still needs network access and valid account authorization.