🎯

netlify

🎯Skill
g1joshi/agent-skills1 Installs9Last Updated Feb 10, 2026

Installation

$npx skills add g1joshi/agent-skills --skill netlify

Run it in a terminal; it asks which AI coding tools to install it for (Claude Code, Codex, Cursor and more).

Uses skills.sh Β· Node.js 22.20+

After installing

Ask for related work and the agent uses it on its own, or call it yourself.

Run it (Claude Code)/netlify
Install by hand

Copy the whole skill folder from GitHub to the place below. Copying only SKILL.md can leave out files the skill uses.

Open the skill folder β†’
  • This project .claude/skills/netlify/
  • All projects ~/.claude/skills/netlify/

These paths are for Claude Code. For other tools, the command above puts it in the right place.

Expert Netlify assistance covering continuous deployments, Netlify Functions, edge redirects (_redirects), and form handling. Use when deploying frontend Jamstack applications and edge web services.

Netlify

Netlify is an essential platform for modern web architectures, providing automated git-based deployments, edge compute, serverless functions, and unified frontend caching primitives.

When to Use

  • Modern Frontend & Jamstack Deployment: Automated git-triggered builds, preview URLs, and global edge CDN hosting.
  • Netlify Edge Functions: Running low-latency serverless TypeScript code at the edge using Deno runtime.
  • Serverless Form Handling & Identity: Zero-backend form submissions and user authentication.
  • Branch Previews & Collaborative Feedback: Generating unique preview environments for every pull request with visual commenting.

Quick Start

npm i -g netlify-cli

# Run local dev environment (simulates Lambda/Edge)
netlify dev

# Deploy
netlify deploy --prod

Core Concepts

Declarative Configuration with netlify.toml

Defining build commands, headers, and SPA redirects:

# netlify.toml
[build]
  command = "npm run build"
  publish = "dist"

[build.environment]
  NODE_VERSION = "22"

# Security headers across all pages
[[headers]]
  for = "/*"
  [headers.values]
    X-Frame-Options = "DENY"
    X-Content-Type-Options = "nosniff"
    Strict-Transport-Security = "max-age=63072000; includeSubDomains; preload"
    Referrer-Policy = "strict-origin-when-cross-origin"

# Single Page App redirect: forward all unhandled paths to index.html
[[redirects]]
  from = "/*"
  to = "/index.html"
  status = 200

# Proxy internal API to external microservice backend
[[redirects]]
  from = "/api/*"
  to = "https://api.backend-internal.com/:splat"
  status = 200
  force = true

Netlify Edge Functions (Deno Runtime)

Running geolocation-based transforms directly at the edge:

// netlify/edge-functions/geo-routing.ts
import type { Context } from "@netlify/edge-functions";

export default async (request: Request, context: Context) => {
  const country = context.geo?.country?.code || "US";

  // Redirect visitors from specific regions
  if (country === "FR") {
    return new Response(null, {
      status: 302,
      headers: { Location: "/fr" },
    });
  }

  // Pass request through to original destination with custom headers
  const response = await context.next();
  response.headers.set("x-visitor-country", country);
  return response;
};

export const config = {
  path: "/*",
};

Automated Netlify Forms

Collecting form submissions without writing backend endpoints:

<!-- Native Netlify form capture -->
<form
  name="contact-us"
  method="POST"
  data-netlify="true"
  netlify-honeypot="bot-field"
>
  <input type="hidden" name="form-name" value="contact-us" />
  <p class="hidden"><input name="bot-field" /></p>

  <label>Email: <input type="email" name="email" required /></label>
  <label>Message: <textarea name="message" required></textarea></label>
  <button type="submit">Send Message</button>
</form>

Common Patterns

Declarative netlify.toml with SPA Fallback and Security Headers

Problem: SPA routes returning 404 on browser refresh, combined with missing security response headers.

Solution: Define routing and headers in netlify.toml:

[build]
  command = "npm run build"
  publish = "dist"

[[redirects]]
  from = "/*"
  to = "/index.html"
  status = 200

[[headers]]
  for = "/*"
  [headers.values]
    X-Frame-Options = "DENY"
    X-Content-Type-Options = "nosniff"
    Referrer-Policy = "strict-origin-when-cross-origin"

Best Practices

Do:

  • Store all routing, redirects, headers, and build commands in netlify.toml for version-controlled reproducibility.
  • Use netlify-honeypot on HTML forms to prevent automated spam bot submissions.
  • Use Netlify Edge Functions for auth checks, localized redirects, and A/B testing at the CDN layer.
  • Test builds and serverless functions locally using the Netlify CLI (netlify dev).

Don't:

  • Commit .env files containing production secrets; configure environment variables in Netlify UI.
  • Use client-side redirects when Netlify edge redirects ([[redirects]]) execute significantly faster.
  • Store large persistent media assets in Git; link to external storage like Cloudinary or S3.

Troubleshooting

ErrorCauseSolution
Page Not Found (404) on route refreshMissing SPA catch-all redirect rule to /index.html.Add /* /index.html 200 to _redirects or netlify.toml.
Build failed: command not found: ...Tool or framework dependency not declared in package.json.Ensure dependencies are in dependencies or devDependencies.
Function invocation timed out (default 10s)Netlify serverless function taking longer than execution limit.Optimize database calls or request timeout extension in site settings.

References

More from this repository10