netlify-config

netlify-config skillの概要

netlify-config の用途

netlify-config skillは、netlify.toml を書いたり調整したりするための実用的なリファレンスです。Netlifyの構文を手探りで覚えるのではなく、build、redirect、rewrite、header、deploy context、environment variables、functions、edge functions を正しく設定したいときに、netlify-config skillを使ってください。

どんな人に向いているか

Netlifyに何をさせたいかは分かっている一方で、それを正確に表現する信頼できる方法が必要な人に最適です。netlify-config guideは、redirectの順序、catch-all routing、context別設定のように、少しのミスで挙動がずれやすいデプロイ変更に特に役立ちます。

何が便利なのか

このskillは、実際の deploy の挙動に効く設定の細部に集中しています。たとえば、file placement、TOML構造、rule matching、conditions や force ルールのような Netlify 固有のオプションです。単なるプロンプトで済ませるか、netlify-config skillを使うか迷うなら、発想よりも正確さが重要な場面では skill のほうが向いています。

netlify-config skillの使い方

skill をインストールして読み込む

まず skills ワークフローで netlify-config の install フローを使い、起点として skills/netlify-config/SKILL.md を開きます。現時点の repository ではこの skill は単一ファイルのリファレンスとして提供されているため、追いかけるべき helper script や companion resource はありません。

目的をそのまま使えるプロンプトに落とし込む

netlify-config をうまく使うには、あいまいな依頼ではなく、具体的な deployment 目標から始めるのが基本です。良い入力には、site の種類、編集中の file、必要な結果が入っています。たとえば、netlify.toml を更新して、production では /docs/* を /docs/index.html に rewrite しつつ、すべての deploy context で /api/* は backend に proxy したままにする、といった形です。

まず読むべき箇所を先に絞る

build 設定と redirect の例から読み始め、その後で変更内容に合う section、つまり headers、deploy contexts、functions、edge functions を確認します。実務では、netlify-config を Deployment に使う最短ルートは、意図した routing の挙動を一番近い example に対応づけてから、構文をゼロから作るのではなく、それを元に調整することです。

出力品質を上げるコツ

現在の file path、framework の output directory、すでに存在する競合ルールを skill に渡してください。rewrite が必要なのか、redirect なのか、proxy なのかも明記しましょう。これらによって正しい status の値や force が必要かどうかが変わります。monorepo で作業しているなら、config が正しい場所に入るよう base directory を明示することも重要です。

netlify-config skill FAQ

netlify-config は netlify.toml 専用ですか？

はい。netlify-config skill は netlify.toml と、それが制御する deploy 挙動に焦点を当てています。Netlify ホスティング戦略全体の相談であっても、核心が config の構文や rule 設計なら、この skill は役に立ちます。

普通のプロンプトで足りるのはどんなときですか？

「Netlify redirects はどう動くの？」のような大まかな理解を得たいだけなら、通常のプロンプトで十分です。netlify-config skill が本領を発揮するのは、routing precedence、rewrites、context 別設定のように、わずかな構文ミスが build の破綻につながる場面で、deploy 可能な答えが必要なときです。

初心者でも使いやすいですか？

はい。deployment の目的を平易な言葉で説明できるなら使えます。主な壁は skill の難しさではなく、入力情報の不足です。初心者ほど、現在の build command、publish folder、変更したい path pattern を具体的に書くと、結果がよくなります。

どんなときに使わないほうがいいですか？

platform をまだ選んでいる段階や、変更先が redirects、headers、build settings のどれか分からない段階では、netlify-config は使わないでください。これは configuration skill であって、Netlify の一般的な解説役でも、site architecture の相談相手でもありません。

netlify-config skillを改善する方法

具体的な routing 問題を伝える

netlify-config skill の出力が最も強くなるのは、path の例が具体的なときです。「redirect を直して」ではなく、旧 path、遷移先、必要な status code、例外条件を伝えてください。そうすれば、skill は 301、302、200、404 のどれを選ぶべきかを曖昧さなく判断できます。

deploy context と制約を含める

netlify-config for Deployment では context が重要です。production 限定の挙動、preview deploy との差分、environment-specific variables などで正解が変わります。ルールを全体に適用するのか、deploy context 配下だけにするのかを明記し、既存の CMS、SPA、API の制約も伝えてください。

助言だけでなく最終ファイルを求める

役立つ netlify-config guide の依頼では、すぐ貼り付けられる正確な netlify.toml の snippet と、それを file のどこに置くべきかを説明する短い注記まで求めるのが理想です。こうするとやり取りが減り、deploy 前に順序ミスを見つけやすくなります。

最初のデプロイテストから反復する

最初の config を書いたら、実際の path 挙動をテストし、Netlify が本当に返している内容をもとに調整します。よくある失敗は、rule の shadowing、force = true の不足、redirect と rewrite の混同です。次のプロンプトでは、意図ではなく、実際に観測された挙動を説明してください。