netlify-skills

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

Skill	What it covers
netlify-functions	Serverless functions — modern syntax, routing, background/scheduled/streaming
netlify-edge-functions	Edge compute — Deno runtime, middleware, geolocation
netlify-blobs	Object storage — key-value and binary data
netlify-database	Managed Postgres (Neon) with Drizzle ORM and migrations
netlify-image-cdn	Image transformation and optimization via CDN
netlify-forms	HTML form handling, AJAX submissions, spam filtering
netlify-config	netlify.toml — redirects, headers, build settings, deploy contexts
netlify-cli-and-deploy	CLI commands, Git vs manual deploys, environment variables
netlify-frameworks	Framework adapters for Vite, Astro, TanStack, and Next.js
netlify-caching	CDN cache control, cache tags, purge, stale-while-revalidate
netlify-ai-gateway	AI Gateway proxy for OpenAI, Anthropic, and Google SDKs
netlify-identity	User authentication — signups, logins, OAuth, role-based access control
netlify-deploy	Deployment workflow — auth, site linking, preview/production deploys

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

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.

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.