Official agent skill

Netlify Deploy

by JetBrains in JetBrains/skills

Deploy web projects to Netlify using the Netlify CLI (npx netlify).

OfficialApache-2.0Auto-check passedDevOps & Cloud

Install Netlify Deploy

skills CLI
$ npx skills add JetBrains/skills --skill netlify-deploy -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install JetBrains/skills netlify-deploy --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/JetBrains/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/netlify-deploy .claude/skills/netlify-deploy && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
netlify-deploy
GitHub stars
364
Used in
5 other repos
Token cost
~1.8k tokens
SKILL.md length
696 words
Files
8 (incl. references, assets)
Skills in repo
77
Repo updated
First seen
Licence
Apache-2.0

At a glance

Deploy web projects to Netlify using the Netlify CLI (npx netlify).

  • Works in 6 steps: Verify Netlify CLI Authentication → Detect Site Link Status → Link to Existing Site or Create New → …
  • The user asks to deploy
  • SKILL.md covers Overview, Prerequisites, Authentication Pattern and Workflow, plus 8 more sections
  • Calls npx, netlify and npm; reaches github.com; needs NETLIFY_AUTH_TOKEN

What it does

Netlify Deploy is an agent skill from JetBrains/skills, published by the product's own GitHub organization. Deploy web projects to Netlify using the Netlify CLI (npx netlify). Use when the user asks to deploy, host, publish, or link a site/repo on Netlify, including preview and production deploys.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including reference files and assets (for example `agents/openai.yaml`, `references/cli-commands.md` and `references/deployment-patterns.md`).

It sits in DevOps & Cloud, covering Deployment. It works with Netlify. The repository describes itself as: Curated agent skills collection verified by JetBrains. The licence is Apache-2.0.

When your agent uses it

  • The user asks to deploy
  • Link a site/repo on Netlify
  • Including preview and production deploys

Example prompts

  • “/netlify-deploy”

Requirements

  • Node.js
  • A credential in NETLIFY_AUTH_TOKEN

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Verify Netlify CLI Authentication
  2. Detect Site Link Status
  3. Link to Existing Site or Create New
  4. Verify Dependencies
  5. Deploy to Netlify
  6. Report Results

What it can do on your machine

Read from SKILL.md and the folder at commit e0f258b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx
    • netlify
    • npm
    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    Also links to:

    • docs.netlify.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • NETLIFY_AUTH_TOKEN

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Netlify Deploy loads about 1.8k tokens when it runs, and up to ~5.1k if it reads all its reference files. Until then it costs about 52 tokens; SKILL.md has 696 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from JetBrains/skills at commit e0f258b, republished under its Apache-2.0 licence (© JetBrains). 696 words, ~1,794 tokens.

Download SKILL.mdSave it as .claude/skills/netlify-deploy/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.
name
netlify-deploy
description
Deploy web projects to Netlify using the Netlify CLI (`npx netlify`). Use when the user asks to deploy, host, publish, or link a site/repo on Netlify, including preview and production deploys.
metadata.short-description
Deploy web projects to Netlify with the Netlify CLI
metadata.author
OpenAI
metadata.source
https://github.com/openai/skills/tree/main/skills/.curated/netlify-deploy

Netlify Deployment Skill

Deploy web projects to Netlify using the Netlify CLI with intelligent detection of project configuration and deployment context.

Overview

This skill automates Netlify deployments by:

  • Verifying Netlify CLI authentication
  • Detecting project configuration and framework
  • Linking to existing sites or creating new ones
  • Deploying to production or preview environments

Prerequisites

  • Netlify CLI: Installed via npx (no global install required)
  • Authentication: Netlify account with active login session
  • Project: Valid web project in current directory
  • When sandboxing blocks the deployment network calls, rerun with sandbox_permissions=require_escalated.
  • The deployment might take a few minutes. Use appropriate timeout values.

Authentication Pattern

The skill uses the pre-authenticated Netlify CLI approach:

  1. Check authentication status with npx netlify status
  2. If not authenticated, guide user through npx netlify login
  3. Fail gracefully if authentication cannot be established

Authentication uses either:

  • Browser-based OAuth (primary): netlify login opens browser for authentication
  • API Key (alternative): Set NETLIFY_AUTH_TOKEN environment variable

Workflow

1. Verify Netlify CLI Authentication

Check if the user is logged into Netlify:

bash
npx netlify status

Expected output patterns:

  • ✅ Authenticated: Shows logged-in user email and site link status
  • ❌ Not authenticated: "Not logged into any site" or authentication error

If not authenticated, guide the user:

bash
npx netlify login

This opens a browser window for OAuth authentication. Wait for user to complete login, then verify with netlify status again.

Alternative: API Key authentication

If browser authentication isn't available, users can set:

bash
export NETLIFY_AUTH_TOKEN=your_token_here

Tokens can be generated at: https://app.netlify.com/user/applications#personal-access-tokens

From netlify status output, determine:

  • Linked: Site already connected to Netlify (shows site name/URL)
  • Not linked: Need to link or create site

If already linked → Skip to step 4

If not linked, attempt to link by Git remote:

bash
# Check if project is Git-based
git remote show origin

# If Git-based, extract remote URL
# Format: https://github.com/username/repo or git@github.com:username/repo.git

# Try to link by Git remote
npx netlify link --git-remote-url <REMOTE_URL>

If link fails (site doesn't exist on Netlify):

bash
# Create new site interactively
npx netlify init

This guides user through:

  1. Choosing team/account
  2. Setting site name
  3. Configuring build settings
  4. Creating netlify.toml if needed
4. Verify Dependencies

Before deploying, ensure project dependencies are installed:

bash
# For npm projects
npm install

# For other package managers, detect and use appropriate command
# yarn install, pnpm install, etc.
5. Deploy to Netlify

Choose deployment type based on context:

Preview/Draft Deploy (default for existing sites):

bash
npx netlify deploy

This creates a deploy preview with a unique URL for testing.

Production Deploy (for new sites or explicit production deployments):

bash
npx netlify deploy --prod

This deploys to the live production URL.

Deployment process:

  1. CLI detects build settings (from netlify.toml or prompts user)
  2. Builds the project locally
  3. Uploads built assets to Netlify
  4. Returns deployment URL
6. Report Results

After deployment, report to user:

  • Deploy URL: Unique URL for this deployment
  • Site URL: Production URL (if production deploy)
  • Deploy logs: Link to Netlify dashboard for logs
  • Next steps: Suggest netlify open to view site or dashboard
Show full SKILL.md (266 more words)Show less

Handling netlify.toml

If a netlify.toml file exists, the CLI uses it automatically. If not, the CLI will prompt for:

  • Build command: e.g., npm run build, next build
  • Publish directory: e.g., dist, build, .next

Common framework defaults:

  • Next.js: build command npm run build, publish .next
  • React (Vite): build command npm run build, publish dist
  • Static HTML: no build command, publish current directory

The skill should detect framework from package.json if possible and suggest appropriate settings.

Example Full Workflow

bash
# 1. Check authentication
npx netlify status

# If not authenticated:
npx netlify login

# 2. Link site (if needed)
# Try Git-based linking first
git remote show origin
npx netlify link --git-remote-url https://github.com/user/repo

# If no site exists, create new one:
npx netlify init

# 3. Install dependencies
npm install

# 4. Deploy (preview for testing)
npx netlify deploy

# 5. Deploy to production (when ready)
npx netlify deploy --prod

Error Handling

Common issues and solutions:

"Not logged in" → Run npx netlify login

"No site linked" → Run npx netlify link or npx netlify init

"Build failed" → Check build command and publish directory in netlify.toml or CLI prompts → Verify dependencies are installed → Review build logs for specific errors

"Publish directory not found" → Verify build command ran successfully → Check publish directory path is correct

Troubleshooting

Escalated Network Access

If deployment fails due to network issues (timeouts, DNS errors, connection resets), rerun the deploy with escalated permissions (use sandbox_permissions=require_escalated). The deploy requires escalated network access when sandbox networking blocks outbound requests.

Example guidance to the user:

The deploy needs escalated network access to deploy to Netlify. I can rerun the command with escalated permissions—want me to proceed?

Environment Variables

For secrets and configuration:

  1. Never commit secrets to Git
  2. Set in Netlify dashboard: Site Settings → Environment Variables
  3. Access in builds via process.env.VARIABLE_NAME

Tips

  • Use netlify deploy (no --prod) first to test before production
  • Run netlify open to view site in Netlify dashboard
  • Run netlify logs to view function logs (if using Netlify Functions)
  • Use netlify dev for local development with Netlify Functions

Reference

Bundled References (Load As Needed)

© JetBrains, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 7 other files (references, assets) in netlify-deploy of JetBrains/skills.

  • SKILL.md
  • LICENSE.txt
  • agents/openai.yaml
  • assets/netlify-small.svg
  • assets/netlify.png
  • references/cli-commands.md
  • references/deployment-patterns.md
  • references/netlify-toml.md

Open the folder on GitHubat commit e0f258b

Used in 5 other repositories

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 5 other GitHub owners. This page covers the copy in JetBrains/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Netlify Deploy next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Netlify Deploy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Netlify Deploy this skillJetBrains/skills3645 repos~1.8kAutomated safety check: PassApache-2.0
Openai Netlify Deploytrailofbits/skills-curated512—~1.7kAutomated safety check: NotesCC-BY-SA-4.0
Deploy Setupgarrytan/gstack136k—~11kAutomated safety check: NotesMIT
Ship And MonitorBuilderIO/agent-native7.1k—~1.3kAutomated safety check: PassNone
Memstack Deployment CI CD Pipelinecwinvestments/memstack423—~3.9kAutomated safety check: NotesProprietary
Memstack Deployment Hetzner Setupcwinvestments/memstack423—~4.1kAutomated safety check: NotesProprietary

Similar skills

  • Openai Netlify Deploy

    trailofbits/skills-curated

    Official

    Deploy web projects to Netlify using the Netlify CLI (npx netlify).

    512 GitHub stars~1.7k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check: notes
  • Deploy Setup

    garrytan/gstack

    Detects where an app deploys, its production URL and health checks, then saves the deploy configuration in CLAUDE.md for /land-and-deploy.

    136k GitHub stars~11k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Ship And Monitor

    BuilderIO/agent-native

    Run the normal guarded ship flow, then do requested post-merge checks.

    7.1k GitHub stars~1.3k tokensUpdated today
    DevOps & CloudAuto-check passed
  • A skill your agent uses when the user says 'CI/CD', 'GitHub Actions', 'pipeline', 'continuous integration', 'continuous deployment', 'ci-cd-pipeline', 'automate deploys', or needs to set up…

    423 GitHub stars~3.9k tokensUpdated 11 days ago
    DevOps & CloudAuto-check: notes
  • Memstack Deployment Hetzner Setup

    cwinvestments/memstack

    A skill your agent uses when the user says 'Hetzner', 'VPS setup', 'server provisioning', 'deploy to VPS', 'hetzner-setup', 'cloud server', or needs to provision, harden, and deploy applications to…

    423 GitHub stars~4.1k tokensUpdated 11 days ago
    DevOps & CloudAuto-check: notes
  • A skill your agent uses when the user says 'deploy to Netlify', 'Netlify setup', 'netlify-deploy', or needs to deploy a static site or serverless functions to Netlify with build configuration and…

    423 GitHub stars~2.6k tokensUpdated 11 days ago
    DevOps & CloudAuto-check passed

More from JetBrains/skills

All 77 skills in this repo
  • Playwright

    JetBrains/skills

    Official

    A skill your agent uses when the task requires automating a real browser from the terminal (navigation, form filling, snapshots, screenshots, data extraction, UI-flow debugging) via playwright-cli…

    364 GitHub starsUsed in 12 repos~986 tokens
    Auto-check passed
  • Skill Creator

    JetBrains/skills

    Official

    Guide for creating effective skills. An agent skill from JetBrains/skills.

    364 GitHub starsUsed in 122 repos~4.7k tokens
    Auto-check passed
  • Transcribe

    JetBrains/skills

    Official

    Transcribe audio files to text with optional diarization and known-speaker hints.

    364 GitHub starsUsed in 5 repos~776 tokens
    Auto-check passed
  • Imagegen

    JetBrains/skills

    Official

    A skill your agent uses when the user asks to generate or edit images via the OpenAI Image API (for example: generate image, edit/inpaint/mask, background removal or replacement, transparent…

    364 GitHub starsUsed in 4 repos~2.5k tokens
    Auto-check passed
  • Speech

    JetBrains/skills

    Official

    A skill your agent uses when the user asks for text-to-speech narration or voiceover, accessibility reads, audio prompts, or batch speech generation via the OpenAI Audio API; run the bundled CLI…

    364 GitHub starsUsed in 4 repos~1.9k tokens
    Auto-check passed
  • Screenshot

    JetBrains/skills

    Official

    A skill your agent uses when the user explicitly asks for a desktop or system screenshot (full screen, specific app or window, or a pixel region), or when tool-specific capture capabilities are…

    364 GitHub starsUsed in 6 repos~2k tokens
    Auto-check passed

Works with

Questions about Netlify Deploy

What does Netlify Deploy do?

Deploy web projects to Netlify using the Netlify CLI (npx netlify). Netlify Deploy is an agent skill from JetBrains/skills, published by the product's own GitHub organization. Deploy web projects to Netlify using the Netlify CLI (npx netlify).

When should I use Netlify Deploy?

Netlify Deploy fits situations like: the user asks to deploy; link a site/repo on Netlify; including preview and production deploys.

How do I install Netlify Deploy in Claude Code?

Run `npx skills add JetBrains/skills --skill netlify-deploy -a claude-code`. Or copy the skill folder (netlify-deploy in JetBrains/skills) into .claude/skills/netlify-deploy in your project. Claude Code loads it when a task matches its description.

How do I install Netlify Deploy in Codex?

Run `npx skills add JetBrains/skills --skill netlify-deploy -a codex`. Or copy the skill folder (netlify-deploy in JetBrains/skills) into .agents/skills/netlify-deploy in your project. Codex loads it when a task matches its description.

Can I use Netlify Deploy in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add JetBrains/skills --skill netlify-deploy -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/netlify-deploy, .gemini/skills/netlify-deploy, .github/skills/netlify-deploy and .opencode/skills/netlify-deploy in your project.

What does Netlify Deploy need to run?

Going by SKILL.md and its folder, Netlify Deploy needs the command-line tools its instructions call (npx, netlify, npm and git) and credentials named NETLIFY_AUTH_TOKEN. Our summary lists: Node.js; A credential in NETLIFY_AUTH_TOKEN.

Does Netlify Deploy access the network?

SKILL.md names 2 domains. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. As links in the text: docs.netlify.com. This is read from the text; nothing was executed.

Is Netlify Deploy safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Netlify Deploy use?

Netlify Deploy is published under the Apache-2.0 licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Netlify Deploy use?

About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.3k tokens, read only when the agent opens those files.

What are the alternatives to Netlify Deploy?

Skills that share tags, products or a category with Netlify Deploy: Openai Netlify Deploy (trailofbits/skills-curated, 512 stars), Deploy Setup (garrytan/gstack, 136k stars), Ship And Monitor (BuilderIO/agent-native, 7.1k stars) and Memstack Deployment CI CD Pipeline (cwinvestments/memstack, 423 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Netlify Deploy?

JetBrains (a GitHub organization, an official publisher) maintains it in JetBrains/skills, which has 364 GitHub stars. The repository holds 77 skills in this directory. The repository was last updated on June 29, 2026.

Source: JetBrains/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.