netlify-config

Generate valid netlify.toml configuration for routing, headers, and build settings.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of setting up and troubleshooting Netlify deployment behavior by providing a comprehensive reference for writing correct netlify.toml configuration.

Core Features & Use Cases

  • Build configuration: Define base directories, build commands, and publish output folders to match your project structure.
  • Routing and redirects: Create SPA catch-alls, wildcard splats, path-parameter mappings, and forced overrides with correct rule ordering.
  • Headers and caching: Apply security headers and long-lived caching headers for static assets served by Netlify’s CDN.
  • Deploy contexts and environment variables: Customize commands and environment values for production, previews, branches, and dev.
  • Functions and Edge Functions: Configure function directories, bundling, scheduled jobs, and edge function routing.
  • Dev server and plugins: Set local dev server behavior and include Netlify plugins like Lighthouse auditing.
  • Image CDN configuration: Restrict and control remote image sources via the images configuration.

Quick Start

Ask an AI to generate a valid netlify.toml that matches your build command, SPA routing needs, and desired security and caching headers, then apply it to your repository root.

Frequently Asked Questions about netlify-config

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

FAQPage Schema
How do I configure SPA catch-all routing in netlify.toml?

To configure SPA catch-all routing in netlify.toml, you define a wildcard redirect rule that points all non-file requests to your application's index.html using correct rule ordering. This ensures client-side routing handles deep links properly without hitting 404 errors.

Can I set different build commands and environment variables for deploy contexts in Netlify?

Yes, you can customize build commands and environment variables for different deploy contexts in Netlify by defining context-specific tables in your netlify.toml. This allows separate configurations for production, branch previews, and dev environments.

What is the correct TOML syntax for adding security and caching headers in Netlify?

Adding security and caching headers in Netlify requires using correct TOML array syntax to define header rules for specific paths. You configure headers by creating a [[headers]] table with strict definitions to apply long-lived caching for static assets and security policies.

How do I configure serverless and edge functions in netlify.toml?

Configuring serverless and edge functions in netlify.toml involves defining function directories, bundling options, scheduled jobs, and edge function routing rules. You must use valid TOML table syntax to ensure Netlify properly deploys and routes your functions.

Does Netlify rule ordering matter for wildcard redirects and path parameters?

Yes, Netlify rule ordering is critical when using wildcard redirects and path-parameter mappings because rules are evaluated from top to bottom. Placing specific path overrides before catch-all splats ensures correct routing precedence and prevents unintended matches.

How do I avoid embedding secrets when configuring environment variables in netlify.toml?

To avoid embedding secrets in version control when using netlify.toml, you should reference sensitive environment variables through Netlify's dashboard rather than hardcoding them. Safe handling guidance ensures deployment configurations remain valid without exposing sensitive values.