netlify

Netlify Context and Tools

Public Netlify skills for AI coding agents. Each skill is a focused, factual reference for a Netlify platform primitive — designed to help agents build correctly on Netlify without needing to search docs.

Skills

References

Some skills include references/ subdirectories with deeper content:

• User-uploaded images pipeline — composing Functions + Blobs + Image CDN
• Vite on Netlify
• Astro on Netlify
• TanStack Start on Netlify
• Next.js on Netlify
• Advanced identity patterns — external providers, role-based access, server-side validation
• CLI commands reference
• Deployment patterns
• netlify.toml guide

Installation

One command installs the skills into any project, from the released @netlify/skills package:

npx @netlify/skills@latest add --all

It writes the skills into the agent directory already in the project (.claude/, .agents/, or .grok/) and never guesses: with none, or more than one, it asks for --agent.

Each directory is the project-level skills location in that agent's own docs: Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot, and Grok. Cursor, Codex, Gemini CLI, and Copilot all read the shared .agents/skills/. The generated .cursor/rules/ files and the codex/AGENTS.md router under Other ways to install are the older formats for those two agents; they still work, but they are not what add writes.

add netlify-functions installs one skill, check reports what is installed and whether it is current, and update brings it up to date. See Install skills and keep them current.

Other ways to install

Each agent's plugin marketplace carries the same skills, packaged the way that agent manages plugins (with the Netlify MCP server bundled where the format allows). Use one of these when you want the agent, not the repo, to own the install.

Codex Desktop App

Install the Netlify plugin from the Codex plugin directory in the Codex desktop app.

The plugin lets Codex deploy to Netlify without leaving your coding workflow. You can create projects, generate preview URLs, deploy to production, validate build configuration, and inspect deploy status and logs. For full details, refer to Deploy from Codex with the Netlify Plugin.

Codex CLI

Copy the pre-built codex/ directory into your project root:

git clone --depth 1 https://github.com/netlify/context-and-tools.git /tmp/netlify-skills && \
  cp -r /tmp/netlify-skills/codex . && \
  rm -rf /tmp/netlify-skills

This gives you codex/AGENTS.md (the skill router) and codex/skills/ with all Netlify skills. Codex discovers AGENTS.md automatically and activates skills by name using $skill-name syntax.

GitHub Copilot CLI

Copy the pre-built codex/ directory into your project root, then point Copilot CLI at it:

git clone --depth 1 https://github.com/netlify/context-and-tools.git /tmp/netlify-skills && \
  cp -r /tmp/netlify-skills/codex . && \
  rm -rf /tmp/netlify-skills

export COPILOT_CUSTOM_INSTRUCTIONS_DIRS="$PWD/codex"

Copilot CLI reads AGENTS.md from any directory listed in COPILOT_CUSTOM_INSTRUCTIONS_DIRS and uses it as a router into the skill files under codex/skills/. Add the export to your shell profile to persist across sessions.

Claude Code

Add the marketplace and install the plugin:

/plugin marketplace add netlify/context-and-tools
/plugin install netlify-skills@netlify-context-and-tools

This installs all Netlify skills into Claude Code. The included skills/CLAUDE.md acts as a router — it tells the agent which skill to read based on what you're building.

VS Code

VS Code's agent plugins use the same plugin format as Claude Code, so VS Code installs the skills directly from this repository — no separate build step or generated output. VS Code auto-detects the plugin from .claude-plugin/plugin.json and loads the skills/ directory and the bundled Netlify MCP server (.mcp.json).

Add this repository as a plugin marketplace, then install:

1. Add the marketplace source netlify/context-and-tools to the chat.plugins.marketplaces setting.
2. Open the Extensions view, search @agentPlugins, find netlify-skills, and click Install.

Or install directly from source via the command palette: Cmd+Shift+P / Ctrl+Shift+P → Chat: Install Plugin From Source → enter https://github.com/netlify/context-and-tools.git.

Cursor

Install from the Cursor plugin marketplace:

1. Open Cursor Settings (Cmd+, / Ctrl+,)
2. Go to Plugins
3. Search for netlify-skills
4. Click Install

Or install via the command palette: Cmd+Shift+P → Plugins: Install Plugin → search netlify-skills.

This installs 21 .mdc rule files covering all Netlify platform primitives. A router rule (netlify-skills-router.mdc) is always active and directs the agent to the right skill for the task.

Manual installation (without the plugin marketplace)

Copy pre-built rule files directly into your project:

git clone --depth 1 https://github.com/netlify/context-and-tools.git /tmp/netlify-skills && \
  mkdir -p .cursor/rules && \
  cp /tmp/netlify-skills/cursor/rules/*.mdc .cursor/rules/ && \
  rm -rf /tmp/netlify-skills

This copies .mdc rule files into .cursor/rules/, where Cursor automatically discovers them.

Grok Build

Netlify is listed in the official xAI plugin marketplace. In Grok Build, open the extensions modal (/plugins) and use the Marketplace tab to find and install netlify.

Grok Build uses the same plugin format as Claude Code, so it installs all Netlify skills directly from this repository — no separate build step or generated output. Marketplace sources live in ~/.grok/config.toml under [[marketplace.sources]]; if the xAI marketplace isn't already configured, add it there. See the xAI Skills, Plugins & Marketplaces docs for details.

Google Antigravity

This repository is an Antigravity plugin: .antigravity-plugin/plugin.json bundles all Netlify skills and the Netlify MCP server (mcp_config.json). In Antigravity, open Customizations → Plugins, click + Install from URL, and enter https://github.com/netlify/context-and-tools. Or from a local clone:

agy plugin install ./context-and-tools

Netlify MCP server

The Claude Code, VS Code, Antigravity, and Grok Build plugins (and the Gemini CLI extension) also register the official Netlify MCP server, giving the agent tools to create and manage Netlify projects, deploys, and environment variables — not just the reference skills.

It connects to Netlify's hosted server over HTTP (https://mcp.netlify.com/mcp) and authorizes via OAuth on first use — no token or local install required. The rules-based integrations (Cursor, Codex, Copilot) don't bundle the MCP server — add it to those clients manually using the Netlify MCP docs.

If you added the Netlify MCP server before it moved to mcp.netlify.com, remove it and add it again: the old host does not redirect to the new one.

Other AI agents

Each SKILL.md file is a self-contained reference with YAML frontmatter (name and description) and markdown body. Feed them into any agent's context as needed.

Hosted skills, manifest, and npm

Every release publishes the skills to two places you can consume without cloning this repo:

• Hosted: https://netlify-agent-skills.netlify.app — manifest.json and skills/<name>/<file> for the latest release, versions.json listing every published version, and immutable copies at v/<version>/….
• npm: @netlify/skills — every skill plus manifest.json and the netlify-skills command, which installs single skills out of the package.