{
  "markdown": "# Netlify Context and Tools\n\nPublic 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.\n\n## Skills\n\n| Skill | What it covers |\n|---|---|\n| [netlify-functions](skills/netlify-functions/SKILL.md) | Serverless functions — modern syntax, routing, background/scheduled/streaming |\n| [netlify-edge-functions](skills/netlify-edge-functions/SKILL.md) | Edge compute — Deno runtime, middleware, geolocation |\n| [netlify-blobs](skills/netlify-blobs/SKILL.md) | Object storage — key-value and binary data |\n| [netlify-database](skills/netlify-database/SKILL.md) | Managed Postgres (Neon) with Drizzle ORM and migrations |\n| [netlify-image-cdn](skills/netlify-image-cdn/SKILL.md) | Image transformation and optimization via CDN |\n| [netlify-forms](skills/netlify-forms/SKILL.md) | HTML form handling, AJAX submissions, spam filtering |\n| [netlify-config](skills/netlify-config/SKILL.md) | `netlify.toml` — redirects, headers, build settings, deploy contexts, environment variables |\n| [netlify-frameworks](skills/netlify-frameworks/SKILL.md) | Framework adapters for Vite, Astro, TanStack, and Next.js |\n| [netlify-caching](skills/netlify-caching/SKILL.md) | CDN cache control, cache tags, purge, stale-while-revalidate |\n| [netlify-ai-gateway](skills/netlify-ai-gateway/SKILL.md) | AI Gateway proxy for OpenAI, Anthropic, and Google SDKs |\n| [netlify-identity](skills/netlify-identity/SKILL.md) | User authentication — signups, logins, OAuth, role-based access control |\n| [netlify-deploy](skills/netlify-deploy/SKILL.md) | CLI install/auth, site linking, Git-based and manual deploys, CI deploys, deploy troubleshooting |\n\n### References\n\nSome skills include `references/` subdirectories with deeper content:\n\n- [User-uploaded images pipeline](skills/netlify-image-cdn/references/user-uploads.md) — composing Functions + Blobs + Image CDN\n- [Vite on Netlify](skills/netlify-frameworks/references/vite.md)\n- [Astro on Netlify](skills/netlify-frameworks/references/astro.md)\n- [TanStack Start on Netlify](skills/netlify-frameworks/references/tanstack.md)\n- [Next.js on Netlify](skills/netlify-frameworks/references/nextjs.md)\n- [Advanced identity patterns](skills/netlify-identity/references/advanced-patterns.md) — external providers, role-based access, server-side validation\n- [CLI commands reference](skills/netlify-deploy/references/cli-commands.md)\n- [Deployment patterns](skills/netlify-deploy/references/deployment-patterns.md)\n- [netlify.toml guide](skills/netlify-deploy/references/netlify-toml.md)\n\n## Installation\n\n### Codex Desktop App\n\nInstall the Netlify plugin from the [Codex plugin directory](https://developers.openai.com/codex/plugins/) in the Codex desktop app.\n\nThe 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](https://www.netlify.com/changelog/2026-03-27-deploy-from-codex-netlify-plugin/).\n\n### Codex CLI\n\nCopy the pre-built `codex/` directory into your project root:\n\n```bash\ngit clone --depth 1 https://github.com/netlify/context-and-tools.git /tmp/netlify-skills && \\\n  cp -r /tmp/netlify-skills/codex . && \\\n  rm -rf /tmp/netlify-skills\n```\n\nThis 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.\n\n### GitHub Copilot CLI\n\nCopy the pre-built `codex/` directory into your project root, then point Copilot CLI at it:\n\n```bash\ngit clone --depth 1 https://github.com/netlify/context-and-tools.git /tmp/netlify-skills && \\\n  cp -r /tmp/netlify-skills/codex . && \\\n  rm -rf /tmp/netlify-skills\n```\n\n```bash\nexport COPILOT_CUSTOM_INSTRUCTIONS_DIRS=\"$PWD/codex\"\n```\n\nCopilot 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.\n\n### Claude Code\n\nAdd the marketplace and install the plugin:\n\n```\n/plugin marketplace add netlify/context-and-tools\n/plugin install netlify-skills@netlify-context-and-tools\n```\n\nThis 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.\n\n### VS Code\n\nVS Code's [agent plugins](https://code.visualstudio.com/docs/agent-customization/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`).\n\nAdd this repository as a plugin marketplace, then install:\n\n1. Add the marketplace source `netlify/context-and-tools` to the `chat.plugins.marketplaces` setting.\n2. Open the Extensions view, search `@agentPlugins`, find **netlify-skills**, and click **Install**.\n\nOr 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`.\n\n### Cursor\n\nInstall from the [Cursor plugin marketplace](https://cursor.com/marketplace):\n\n1. Open Cursor Settings (`Cmd+,` / `Ctrl+,`)\n2. Go to **Plugins**\n3. Search for **netlify-skills**\n4. Click **Install**\n\nOr install via the command palette: `Cmd+Shift+P` → **Plugins: Install Plugin** → search **netlify-skills**.\n\nThis 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.\n\n<details>\n<summary>Manual installation (without the plugin marketplace)</summary>\n\nCopy pre-built rule files directly into your project:\n\n```bash\ngit clone --depth 1 https://github.com/netlify/context-and-tools.git /tmp/netlify-skills && \\\n  mkdir -p .cursor/rules && \\\n  cp /tmp/netlify-skills/cursor/rules/*.mdc .cursor/rules/ && \\\n  rm -rf /tmp/netlify-skills\n```\n\nThis copies `.mdc` rule files into `.cursor/rules/`, where Cursor automatically discovers them.\n\n</details>\n\n\n\n### Grok Build\n\nNetlify is listed in the [official xAI plugin marketplace](https://github.com/xai-org/plugin-marketplace). In Grok Build, open the extensions modal (`/plugins`) and use the **Marketplace** tab to find and install **netlify**.\n\nGrok 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](https://docs.x.ai/build/features/skills-plugins-marketplaces) for details.\n\n### Netlify MCP server\n\nThe Claude Code, VS Code, and Grok Build plugins (and the Gemini CLI extension) also register the [official Netlify MCP server](https://docs.netlify.com/build/build-with-ai/netlify-mcp-server/), giving the agent tools to create and manage Netlify projects, deploys, and environment variables — not just the reference skills.\n\nIt connects to Netlify's hosted server over HTTP (`https://netlify-mcp.netlify.app/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](https://docs.netlify.com/build/build-with-ai/netlify-mcp-server/).\n\n### Other AI agents\n\nEach `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.\n\n## Design Principles\n\n- **Factual, not opinionated** — platform behavior and API reference, not workflow preferences\n- **Composable** — skills cover individual primitives; agents combine them as needed\n- **Concise** — each SKILL.md stays under 500 lines; detailed content goes in `references/`\n- **Current** — covers modern Netlify patterns (v2 functions, Vite plugin, AI Gateway)\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for commit/PR title conventions and how releases are cut.\n\nKeep skills focused on Netlify platform primitives. Each skill should answer \"how does this Netlify feature work?\" rather than \"how should I structure my project?\"\n\nFollow the existing format: YAML frontmatter with `name` and `description`, markdown body, code examples with TypeScript where applicable. Use `references/` subdirectories for content that would push a SKILL.md past 500 lines.\n\n### Cursor rules and Codex skills are generated — do not edit them directly\n\nThe `cursor/rules/` and `codex/` directories are auto-generated from `skills/` by a GitHub Actions workflow. Always edit the source files in `skills/`. On same-repo PRs and on every push to `main` that changes `skills/`, the workflow rebuilds the mirrors and commits them alongside your change — you don't need to run the build yourself. (Fork PRs can't be committed to automatically; include the regenerated output in your PR, or a maintainer will regenerate it.) To preview locally:\n\n```bash\nbash scripts/build-cursor-rules.sh\nbash scripts/build-codex-skills.sh\n```\n",
  "bytes": 9564,
  "sha": "eae4390e4e9c5f8ccd1fa62ad4499ef4315c07f3be343d7958b583ea7d4e00e9",
  "repo_slug": "costrict-plugins-repo/anthropic-netlify-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_costrict_plugins_repo_anthropic_netlify__8a9cf287/readme"
}