# netlify-deploy

A Claude skill that walks a web project through a Netlify release: auth check, site linking, build and upload to a preview or production URL.

- skill · `type=skill` · Claude Code · 58 installs
- Author: openai
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/development/netlify-deploy
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/netlify-deploy

## What it does

The skill wraps the everyday parts of `npx netlify`. It starts by reading `npx netlify status`; with no active session it points you to `npx netlify login` or to setting `NETLIFY_AUTH_TOKEN`. Then it works out whether a site is already attached. For a Git project it tries `npx netlify link --git-remote-url <REMOTE_URL>`. When no Netlify site exists yet, `npx netlify init` takes over and handles team, site name and build settings.

Dependencies come next — `npm install` for an npm project. Publishing happens in two stages: `npx netlify deploy` returns a preview link with its own address, while `npx netlify deploy --prod` pushes to the live URL. Build config is read from `netlify.toml` when present. Without it, the CLI asks for a build command and publish directory, and the skill can suggest values based on the framework in `package.json`.

You need a Netlify account with an active login, and a deploy can run for several minutes, so set the timeout generously. Sandboxed networking that blocks outbound calls is a real blocker here: timeouts, DNS failures or dropped connections mean the upload never reaches Netlify. The fix is a rerun with `sandbox_permissions=require_escalated`.

## Install

### Claude Code (native platform)

1. **claude-code-templates**
```bash
npx claude-code-templates@latest --skill development/netlify-deploy
```

2. **Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill netlify-deploy -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/netlify-deploy/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/netlify-deploy/

### Codex

**Manually: put the files in place**
- File: `.agents/skills/netlify-deploy/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/netlify-deploy/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates netlify-deploy
```

2. **Manually: put the files in place**
- File: `.github/skills/netlify-deploy/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/development/netlify-deploy
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/netlify-deploy/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/development/netlify-deploy

## When to use it
- publish the current project folder to Netlify
- attach a repo to an existing Netlify site by its Git remote
- get a preview URL for testing before going live
- set a build command and publish directory without a netlify.toml
- find out why a deploy dies at login or at build

## Example prompts
- Check my Netlify login and deploy this as a preview
- Link this repo to a Netlify site, then build and push to production
- Run `npx netlify deploy --prod` and give me the site URL

## Similar
- [wizard](https://affpapa.org/en/nevibecode/skills/wizard.md) — skill · 553369 installs
- [hyperframes-cli](https://affpapa.org/en/nevibecode/skills/heygen-com-hyperframes-cli.md) — skill · 1300000 installs
- [setup-pre-commit](https://affpapa.org/en/nevibecode/skills/setup-pre-commit.md) — skill · 489289 installs
- [using-git-worktrees](https://affpapa.org/en/nevibecode/skills/using-git-worktrees.md) — skill · 217153 installs
- [finishing-a-development-branch](https://affpapa.org/en/nevibecode/skills/finishing-a-development-branch.md) — skill · 214439 installs
- [orca-cli](https://affpapa.org/en/nevibecode/skills/orca-cli.md) — skill · 354000 installs

## Other versions with the same name
- [netlify-deploy · netlify](https://affpapa.org/en/nevibecode/skills/netlify-netlify-deploy.md) — 3400 installs

From the same set: [davila7/claude-code-templates](https://affpapa.org/en/nevibecode/by/davila7/claude-code-templates.md) — 804 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md