Skip to content

netlify/context-and-tools

Repository files navigation

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-db 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-deploy Deployment workflow — auth, site linking, preview/production deploys

References

Some skills include references/ subdirectories with deeper content:

Installation

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+PPlugins: 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.

Codex

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.

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.

Design Principles

  • Factual, not opinionated — platform behavior and API reference, not workflow preferences
  • Composable — skills cover individual primitives; agents combine them as needed
  • Concise — each SKILL.md stays under 500 lines; detailed content goes in references/
  • Current — covers modern Netlify patterns (v2 functions, Vite plugin, AI Gateway)

Contributing

Keep skills focused on Netlify platform primitives. Each skill should answer "how does this Netlify feature work?" rather than "how should I structure my project?"

Follow 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.

Cursor rules and Codex skills are generated — do not edit them directly

The cursor/rules/ and codex/ directories are auto-generated from skills/ by GitHub Actions workflows. Always edit the source files in skills/ — the workflows rebuild on every push to main that changes skills/. To test locally:

bash scripts/build-cursor-rules.sh
bash scripts/build-codex-skills.sh

About

No description, website, or topics provided.

Resources

License

Code of conduct

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages