netlify-config

Aperçu du skill netlify-config

À quoi sert netlify-config

Le skill netlify-config est une référence pratique pour écrire et ajuster netlify.toml. Utilisez le skill netlify-config lorsque vous devez configurer des builds, des redirections, des réécritures, des en-têtes, des contextes de déploiement, des variables d’environnement, des fonctions ou des edge functions sans avoir à deviner la syntaxe Netlify.

À qui il s’adresse

Il convient surtout aux personnes qui savent déjà ce qu’elles veulent faire sur Netlify, mais ont besoin d’un moyen fiable de l’exprimer correctement. Le guide netlify-config est particulièrement utile pour les changements de déploiement qu’il est facile de rater subtilement, comme l’ordre des redirections, le routage catch-all ou les paramètres spécifiques à un contexte.

Pourquoi il est utile

Ce skill se concentre sur les détails de configuration qui influencent réellement le comportement d’un déploiement : emplacement du fichier, structure TOML, correspondance des règles et options propres à Netlify comme les conditions et les règles force. Si vous hésitez entre un simple prompt et le skill netlify-config, le skill est préférable quand la justesse compte davantage que le brainstorming.

Comment utiliser le skill netlify-config

Installer et charger le skill

Suivez le flux d’installation netlify-config dans votre workflow de skills, puis ouvrez skills/netlify-config/SKILL.md comme point de départ. Le dépôt présente actuellement le skill comme une référence en un seul fichier : il n’y a donc ni scripts d’assistance ni ressources associées à aller chercher ailleurs.

Transformer votre objectif en prompt exploitable

La meilleure utilisation de netlify-config commence par un objectif de déploiement concret, pas par une demande vague. Un bon prompt indique le type de site, le fichier que vous modifiez et le résultat attendu. Par exemple : « Mettez à jour netlify.toml pour que /docs/* se réécrive vers /docs/index.html en production, tout en gardant /api/* en proxy vers le backend dans tous les contextes de déploiement. »

Lire d’abord les bonnes sections

Commencez par les exemples de paramètres de build et de redirections, puis examinez les sections qui correspondent à votre changement : en-têtes, contextes de déploiement, fonctions ou edge functions. En pratique, la façon la plus rapide d’utiliser netlify-config pour un déploiement consiste à rapprocher votre comportement de routage cible de l’exemple le plus proche, puis à adapter la syntaxe au lieu de la réinventer.

Conseils pour améliorer la qualité du résultat

Donnez au skill le chemin actuel du fichier, le répertoire de sortie du framework et les éventuelles règles déjà en conflit. Précisez si vous avez besoin d’une réécriture, d’une redirection ou d’un proxy, car ces choix modifient la bonne valeur de status et déterminent si force est nécessaire. Si vous travaillez dans un monorepo, indiquez explicitement le répertoire de base pour que la configuration soit placée au bon endroit.

FAQ sur le skill netlify-config

netlify-config sert-il uniquement à netlify.toml ?

Oui, le skill netlify-config est centré sur netlify.toml et sur le comportement de déploiement qu’il contrôle. Si votre problème concerne plus largement la stratégie d’hébergement Netlify, ce skill reste utile dès que l’enjeu principal est la syntaxe de configuration ou la conception des règles.

Quand un prompt classique suffit-il ?

Un prompt classique convient pour des idées générales du type « comment fonctionnent les redirections Netlify ? ». Le skill netlify-config est meilleur quand vous avez besoin d’une réponse directement exploitable en déploiement, surtout pour la priorité des routes, les réécritures ou les paramètres spécifiques à un contexte, là où une petite erreur de syntaxe peut casser un build.

Est-ce adapté aux débutants ?

Oui, si vous êtes capable de décrire votre objectif de déploiement en langage simple. Le principal obstacle n’est pas la difficulté du skill ; c’est un input incomplet. Les débutants obtiennent de meilleurs résultats s’ils fournissent la commande de build actuelle, le dossier de publication et les motifs de chemins qu’ils veulent modifier.

Quand ne faut-il pas l’utiliser ?

N’utilisez pas netlify-config si vous hésitez encore entre plusieurs plateformes ou si vous ne savez pas si la modification relève des redirections, des en-têtes ou des paramètres de build. C’est un skill de configuration, pas un assistant général d’explication Netlify ni un conseiller en architecture de site.

Comment améliorer le skill netlify-config

Décrivez précisément le problème de routage

Les meilleurs résultats du skill netlify-config viennent d’exemples de chemins précis. Au lieu de dire « corrige les redirections », donnez l’ancien chemin, le chemin cible, le code de statut souhaité et les exceptions éventuelles. Le skill peut ainsi choisir sans ambiguïté entre 301, 302, 200 et 404.

Ajoutez le contexte de déploiement et les contraintes

Pour netlify-config en déploiement, le contexte compte : comportement réservé à la production, différences entre déploiements de prévisualisation et variables propres à l’environnement changent la bonne réponse. Précisez si la règle doit s’appliquer globalement ou seulement dans un contexte de déploiement, et mentionnez toute contrainte existante liée au CMS, à l’application SPA ou à l’API.

Demandez le fichier final, pas seulement des conseils

Une demande utile pour netlify-config devrait demander l’extrait exact de netlify.toml à coller, ainsi qu’une courte note indiquant où l’insérer dans le fichier. Cela réduit les allers-retours et facilite la détection des erreurs d’ordre avant le déploiement.

Itérez à partir du premier test de déploiement

Une fois la première configuration écrite, testez le comportement réel des chemins et ajustez selon ce que Netlify sert effectivement. Les échecs fréquents incluent le masquage par une autre règle, l’absence de force = true et la confusion entre redirections et réécritures ; le prompt suivant doit décrire le comportement observé, pas seulement l’intention initiale.