netlify-deploy

netlify-deploy スキルの概要

netlify-deploy は、Netlify CLI を使って Web プロジェクトを Netlify に公開するための、デプロイ特化型スキルです。ローカルリポジトリからプレビュー URL あるいは本番 URL まで、段階を追って進めたい人に向いています。特に、リンク設定、認証、デプロイ前の build 設定確認が必要なプロジェクトでは効果を発揮します。

やるべきことはシンプルです。一般的な「Netlify にデプロイして」という曖昧な指示よりも、試行錯誤を減らしながら実プロジェクトをきちんと公開すること。netlify-deploy スキルは、既存サイトにリンクするのか、新しく作るのか、まずプレビューを出すのかを判断したいときに役立ちます。netlify.toml、framework の自動検出、そして初回の本番デプロイを壊さずに進めることを重視する場合にも特に有用です。

netlify-deploy スキルの用途

netlify-deploy は、Netlify 上でサイトをホスト、公開、プレビュー、更新する作業に使います。静的サイト、SPA のフロントエンド、そして Netlify が設定から検出または上書きできる framework build に適しています。これは単に「コマンドを実行する」ためのスキルではなく、公開前に認証、サイトのリンク状態、publish 設定を確認するデプロイワークフローです。

このスキルが特に向いているケース

次のような場合は、この netlify-deploy skill を選ぶとよいでしょう。

• ローカル repo から初めて Netlify を設定したい
• 本番前に確認用の preview deploy を出したい
• build output ディレクトリが分かっている production deploy を行いたい
• netlify.toml の内容を読み解く、または形を整える支援がほしい
• サイトがまだ link されていない状態から復帰できる手順が必要

インストール前に最も重要なこと

repo の内容から、実際のデプロイワークフローが想定されていることが分かります。つまり、認証チェック、link/init の判断、preview と production のコマンド分岐、config 参照が揃っています。そのため、前提を減らし、デプロイ手順を明確にしたい場合に価値があります。すでに Netlify の設定を完全に把握していて、1 回だけコマンドを打ちたいだけなら、この追加ガイダンスは不要かもしれません。

netlify-deploy スキルの使い方

まずインストールして、適切なファイルを読む

netlify-deploy install は次のコマンドで実行します。

npx skills add openai/skills --skill netlify-deploy

インストール後は、まず SKILL.md を読み、続いて references/cli-commands.md、references/deployment-patterns.md、references/netlify-toml.md を確認してください。あわせて、デフォルトのデプロイ意図は agents/openai.yaml で見られます。これらのファイルが示す実務的な流れは、認証して、site を link するか init し、そのうえで正しい output directory を指定して deploy することです。

曖昧な目的を使えるプロンプトに変える

netlify-deploy usage は、「deploy して」だけではなく、デプロイの文脈を含めるほど精度が上がります。良い入力には、次のような情報が含まれることが多いです。

• repo か現在のディレクトリ
• 新規 site か既存の Netlify site か
• preview か production か
• build command と publish directory が分かるならそれ
• Next.js、Vite、Astro、SvelteKit などの framework 情報
• 認証や sandbox の制約

例:
「netlify-deploy スキルを使って、この Vite app を現在のディレクトリからまず preview URL に deploy して。publish directory が dist か確認し、production 前に netlify.toml の変更が必要か教えてください。」

Netlify が実際に必要とするワークフローに沿って進める

この repo は、規模は小さくても重要な分岐を前提に最適化されています。

1. npx netlify status で確認する
2. 必要なら npx netlify login でログインする
3. npx netlify link または npx netlify init で既存 site を link するか新規作成する
4. npx netlify deploy で preview deploy する
5. npx netlify deploy --prod で production deploy する

最良の結果を得るには、site がすでに存在するかどうか、そして安全な preview か live release かをスキルに伝えてください。そうすると推測が減り、deploy、link、init の使い分けもしやすくなります。

スキルが使える config の手がかりを渡す

build output が標準的でない場合は、publish path を明示してください。framework の自動検出が誤る場合は、想定している framework と build command を伝えてください。たとえば、「npm run build で build に出力される。repo root から deploy したい」といった指定です。こうした具体性は、「うまくいきません」よりずっと役に立ちます。

netlify-deploy スキル FAQ

Netlify の経験がなくても netlify-deploy は使えますか？

はい。netlify-deploy skill は、認証から link/init までの流れに沿って進むため、初心者にも使いやすいです。動くローカルプロジェクトと Netlify アカウントは必要ですが、先に CLI を暗記しておく必要はありません。

単にモデルに「デプロイして」と頼むのと何が違いますか？

違います。汎用プロンプトだと、認証、site の link 状態、netlify.toml の確認が抜け落ちがちです。netlify-deploy は、Netlify の実際の CLI 動作に沿ったデプロイ経路が必要なとき、そして不足しているデプロイ情報を勝手に補完するのではなく質問してほしいときに向いています。

どんな場合にこのスキルを使うべきではありませんか？

Netlify にデプロイしない場合、プロジェクトに build 可能な Web app がない場合、あるいは完全にスクリプト化された CI/CD パイプラインがすでにあり、単に 1 つのコマンドだけ欲しい場合は、netlify-deploy は使わないでください。また、repo アクセス、build の文脈、認証情報を渡せない状況でも、あまり適していません。

最初の実行では何が起こると想定すべきですか？

まず認証を確認し、site が link 済みかどうかを判定し、本番 deploy の前に build や publish の問題を表面化させる流れを想定してください。プロジェクトに config 変更が必要なら、初回の実行は live release ではなく preview deploy か修正点の一覧で終わることがあります。netlify-deploy にとっては、通常それが正しい結果です。

netlify-deploy スキルを改善するには

build の実態を先に伝える

品質を最も大きく引き上げるのは、build の挙動を正確に伝えることです。コマンド、出力先フォルダ、framework を含めてください。たとえば、「npm run build の出力先は dist で、アプリはクライアントサイドルーティングの Vite SPA です」という具合です。これにより、netlify-deploy が誤った publish path や壊れた fallback 動作を選ぶのを防げます。

デプロイの目的を明確にする

preview が欲しいのか、本番 release が欲しいのか、既存 site の link を手伝ってほしいのかをはっきり伝えてください。「preview に deploy して URL を教えてほしい」と「本番公開できる状態にしたい」では、必要なワークフローが違います。netlify-deploy usage を効率よく使いたいなら、どの程度のリスクを許容するかをスキルに推測させないことです。

よくある失敗パターンに注意する

典型的な問題は、認証不足、publish directory の誤り、そして Netlify の自動検出 framework と実際の build output の不一致です。deploy に失敗したとき、次に渡すべきなのは「もう一度試して」ではありません。実際のコマンド出力と、関連する netlify.toml の該当セクションです。そうすれば、次の試行で成功する確率が大きく上がります。

具体的な制約を追加して反復する

最初の出力が惜しいところまで来ているなら、「build command は変えないでください」「既存 site の link は維持してください」「preview deploy のみ使ってください」のように制約を足して絞り込みます。netlify-deploy guide は、失敗した箇所が認証、link、config、publish path のどれかを見極めて、そこから調整するときに最も力を発揮します。