netlify-config

Descripción general de la skill netlify-config

Para qué sirve netlify-config

La skill netlify-config es una referencia práctica para escribir y ajustar netlify.toml. Usa la skill netlify-config cuando necesites configurar builds, redirects, rewrites, headers, deploy contexts, variables de entorno, functions o edge functions sin tener que adivinar la sintaxis de Netlify.

Quién debería usarla

Es ideal para quienes ya saben qué quieren que haga Netlify, pero necesitan una forma fiable de expresarlo correctamente. La guía netlify-config resulta especialmente útil para cambios de despliegue que es fácil equivocarlos sin darse cuenta, como el orden de los redirects, el enrutado catch-all o los ajustes específicos por contexto.

Por qué es útil

Esta skill se centra en los detalles de configuración que afectan el comportamiento real del deploy: ubicación del archivo, estructura TOML, coincidencia de reglas y opciones específicas de Netlify como conditions y reglas force. Si estás decidiendo entre un prompt genérico y la skill netlify-config, la skill es mejor cuando la corrección importa más que la lluvia de ideas.

Cómo usar la skill netlify-config

Instala y carga la skill

Sigue el flujo de instalación de netlify-config dentro de tu proceso de trabajo con skills y luego abre skills/netlify-config/SKILL.md como punto de partida. En el repositorio, la skill se presenta actualmente como una referencia de un solo archivo, así que no hay scripts auxiliares ni recursos complementarios que perseguir.

Convierte tu objetivo en un prompt útil

El mejor uso de netlify-config empieza con un objetivo de despliegue concreto, no con una petición vaga. Un buen input nombra el tipo de sitio, el archivo que estás editando y el resultado que necesitas. Por ejemplo: “Actualiza netlify.toml para que /docs/* reescriba a /docs/index.html en producción, pero mantén /api/* haciendo proxy al backend en todos los deploy contexts.”

Lee primero las partes correctas

Empieza por los ejemplos de build settings y redirects, y después revisa las secciones que coincidan con tu cambio: headers, deploy contexts, functions o edge functions. En la práctica, la forma más rápida de usar netlify-config para Deployment es mapear el comportamiento de enrutado que quieres al ejemplo más parecido y luego adaptar la sintaxis en lugar de inventarla desde cero.

Consejos para mejorar la calidad de salida

Dale a la skill la ruta actual del archivo, el directorio de salida del framework y cualquier regla en conflicto que ya exista. Indica si necesitas un rewrite, un redirect o un proxy, porque esas decisiones cambian el valor correcto de status y si hace falta force. Si trabajas en un monorepo, señala explícitamente el base directory para que la configuración quede en el lugar correcto.

Preguntas frecuentes sobre la skill netlify-config

¿netlify-config es solo para netlify.toml?

Sí, la skill netlify-config se centra en netlify.toml y en el comportamiento de despliegue que controla. Si tu problema es una estrategia más amplia de hosting en Netlify, esta skill sigue siendo útil cuando la tarea principal es la sintaxis de configuración o el diseño de reglas.

¿Cuándo basta con un prompt normal?

Un prompt normal sirve para ideas generales como “¿cómo funcionan los redirects de Netlify?”. La skill netlify-config es mejor cuando necesitas una respuesta lista para desplegar, sobre todo para la precedencia de rutas, los rewrites o los ajustes específicos por contexto, donde pequeños errores de sintaxis rompen el build.

¿Es apta para principiantes?

Sí, si puedes describir tu objetivo de despliegue en lenguaje claro. La principal barrera no es la dificultad de la skill, sino la falta de información completa. Los principiantes obtienen mejores resultados cuando incluyen el comando de build actual, la carpeta de publicación y los patrones de ruta que quieren cambiar.

¿Cuándo no debería usarla?

No uses netlify-config si todavía estás eligiendo plataforma o no sabes si el cambio pertenece a redirects, headers o build settings. Es una skill de configuración, no un explicador general de Netlify ni un asesor de arquitectura del sitio.

Cómo mejorar la skill netlify-config

Proporciona el problema exacto de enrutado

Las salidas más sólidas de la skill netlify-config salen de ejemplos precisos de rutas. En vez de “arregla los redirects”, indica la ruta antigua, la ruta destino, el código de estado deseado y cualquier excepción. Eso permite que la skill elija entre 301, 302, 200 y 404 sin ambigüedad.

Incluye el contexto de despliegue y las restricciones

Para netlify-config for Deployment, el contexto importa: el comportamiento solo en producción, las diferencias entre preview deploys y las variables específicas de entorno cambian la respuesta correcta. Di si la regla debe aplicarse globalmente o solo dentro de un deploy context, y menciona cualquier restricción existente de CMS, SPA o API.

Pide el archivo final, no solo orientación

Una solicitud útil para netlify-config debería pedir el fragmento exacto de netlify.toml que puedas pegar tal cual, además de una nota breve que explique en qué parte del archivo debe ir. Esto reduce el ir y venir y facilita detectar errores de orden antes de desplegar.

Itera a partir de la primera prueba de despliegue

Una vez escrita la primera configuración, prueba el comportamiento real de la ruta y ajústalo según lo que Netlify sirva de verdad. Entre los fallos más comunes están el shadowing de reglas, la ausencia de force = true y confundir redirects con rewrites; el siguiente prompt debería describir el comportamiento observado, no solo el que intentabas conseguir.