netlify-config

Configure Netlify builds, redirects, headers, and deploy contexts via netlify.toml.

Updated May 31, 2026
One-click install
npx skills add https://github.com/ChristineTham/lp --skill netlify-config-christinetham
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: netlify-config
Source: https://github.com/ChristineTham/lp/tree/main/.agents/skills/netlify-config
Command: npx skills add https://github.com/ChristineTham/lp --skill netlify-config-christinetham

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Netlify configuration can be error-prone and repetitive. This skill provides a definitive guide to netlify.toml syntax and best practices, covering builds, redirects, headers, contexts, functions, and edge configurations to streamline deployment setups.

Core Features & Use Cases

  • Comprehensive netlify.toml reference covering redirects (including splats and conditions), headers, deploy contexts, functions configuration, and edge functions configuration.
  • Guidance for project-level and monorepo deployments with practical examples and recommended patterns.
  • Clear, scalable configuration guidance designed for teams working across multiple sites and environments.

Quick Start

Start with a minimal netlify.toml at the project root and gradually extend redirects, headers, and contexts to fit your deployment needs.

Frequently Asked Questions about netlify-config

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure redirects and headers in netlify.toml?

To configure redirects and headers in netlify.toml, define structured syntax blocks for each rule, specifying status codes, splat parameters, and conditions. This enforces validated routing and security header policies across deployment contexts.

What is the best way to manage Netlify build settings for a monorepo?

The best way to manage Netlify build settings for a monorepo is using netlify.toml to specify project-level base directories and build commands. This provides scalable configuration guidance for teams deploying multiple sites from a single repository.

Can I use deploy contexts to customize Netlify environment settings?

Yes, you can use deploy contexts in netlify.toml to customize environment settings for specific branches. Defining context-specific variables and build commands allows distinct configurations for production, deploy previews, and branch deployments.

How do edge functions work with Netlify configuration?

Edge functions work with Netlify configuration by declaring function paths and routes within netlify.toml. This integrates edge logic directly into your deployment setup, allowing you to run code closer to users alongside standard build and redirect rules.

Why are my Netlify redirects with splats not working as expected?

Netlify redirects with splats fail when the structured syntax in netlify.toml is misconfigured or missing required placeholders. Validating the redirect rules against the complete reference ensures splats correctly capture and forward path segments.