netlify-deploy

netlify-deploy skill の概要

netlify-deploy は、Netlify CLI を使って Web プロジェクトを Netlify に公開するためのデプロイ特化スキルです。ローカルのリポジトリからプレビューまたは本番デプロイまでを再現性高く進めたい場合に最適で、とくにプロジェクトのリンク、初期化、認証が先に必要になるケースで力を発揮します。

netlify-deploy skill の強みは、単に「deploy を実行する」ことではなく、「このリポジトリに最適な Netlify の流れを見極める」ことにあります。サイトがすでにリンク済みかどうかの判定、プレビューと本番の切り分け、netlify.toml ベースのビルド設定への対応まで含めて考えます。

この skill が向いている用途

次のような目的で netlify-deploy skill を使います。

• ローカルの Web アプリ、静的サイト、フレームワークアプリを Netlify にデプロイする
• 新規プロジェクトの初回デプロイを行う
• 既存の Git リポジトリやローカルフォルダを既存の Netlify サイトにリンクする
• 本番公開前にプレビューデプロイを作成する

他とどう違うか

netlify-deploy の主な価値は、コマンド一覧だけでなくワークフローの判断まで支援する点にあります。Netlify CLI を中心に据え、まず認証を確認し、リンクされていないサイト、公開ディレクトリの不足、ビルド設定の不備といった典型的な詰まりどころまで織り込みます。

どんな場面に最適か

この skill は、すでに実在するプロジェクトディレクトリがあり、信頼できるデプロイ手順を求めている人に向いています。リポジトリ単位の具体的な作業に踏み込めない抽象的な「Netlify の使い方」だけを知りたい場合は、あまり向きません。

netlify-deploy skill の使い方

まずインストールして skill 自体を読む

netlify-deploy install では、まず skill 本体から入り、コマンド選択を支える参照資料を確認します。

• SKILL.md
• references/cli-commands.md
• references/deployment-patterns.md
• references/netlify-toml.md

ここにはスクリプト層はないため、判断の要点は参照資料にあります。login、link、init、プレビューデプロイ、本番デプロイのどれを選ぶべきか迷うなら、まず deployment-patterns.md を読みます。

曖昧な目的を使えるプロンプトに言い換える

この skill は、ユーザーがリポジトリの状態とデプロイ先を明確に伝えるほど機能します。強い netlify-deploy usage プロンプトには次の情報が入ります。

• 分かっている範囲でのフレームワークやビルドツール
• サイトがすでに Netlify 上に存在するかどうか
• 目的がプレビューか本番か
• 想定されるビルド出力フォルダ
• netlify.toml がすでにあるかどうか

例:
「この Vite アプリを Netlify にデプロイしてください。まだリンクされていません。本番デプロイにしたいです。ビルド出力は dist です。」

弱い入力:
「サイトをデプロイして。」

おすすめのワークフロー

実用的な netlify-deploy guide の流れは次のとおりです。

1. npx netlify status で認証状態を確認する。
2. 必要なら npx netlify login で認証する。
3. 既存サイトをリンクするか、npx netlify link または npx netlify init で新規作成するかを決める。
4. netlify.toml でビルド出力と設定を確認する。
5. プレビューなら npx netlify deploy、本番なら npx netlify deploy --prod を実行する。

設定ファイルを見て推測を減らす

デプロイ前に、netlify.toml があれば必ず確認します。とくに重要なのは build.command、build.publish、それからコンテキスト別の環境設定です。公開パスが実際のビルド出力と一致していないと、デプロイ自体は成功しても誤ったディレクトリを配信したり、検証で失敗したりします。

netlify-deploy skill の FAQ

netlify-deploy は Netlify CLI ユーザー専用ですか？

はい。npx netlify と CLI のワークフローを前提にした skill です。ダッシュボードだけで完結したいなら、これは適切ではない可能性があります。

使うには、あらかじめプロジェクトがリンク済みである必要がありますか？

いいえ。netlify-deploy skill は初回セットアップにも、既存サイトにも対応しています。リポジトリが未リンクなら、デプロイ前に link か init へ切り替える流れになります。

一般的なデプロイ用プロンプトより優れていますか？

多くの場合はそうです。netlify-deploy には、認証してからリンクまたは init、設定確認、そしてデプロイという Netlify の実際の手順が組み込まれているためです。これにより、デプロイを止める前提条件の見落としを減らせます。

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

プロジェクトが Web アプリではない場合、CLI コマンドを実行できない場合、あるいは Netlify だけでなくホスティング全般を比較したい場合は、netlify-deploy は使わないほうがよいです。

netlify-deploy skill を改善するには

デプロイ経路を左右するリポジトリ情報を渡す

品質を最も大きく上げるのは、skill が安全に推測できない情報を明示することです。

• framework: Next.js, Astro, Vite, SvelteKit など
• build command: npm run build, pnpm build, またはカスタムコマンド
• publish directory: dist, build, .next, など
• site state: 新規、リンク済み、すでにデプロイ済み
• target: preview または production

こうした情報があれば、netlify-deploy skill は試行錯誤なしで適切な CLI パスを選べます。

設定の不一致は早めに明示する

よくある失敗は、Netlify がすべてを正しく自動検出してくれると思い込むことです。アプリが標準的でない出力ディレクトリ、モノレポ構成、独自のベースパスを使っているなら、最初にその点を伝え、skill を netlify.toml に向けてください。とくにモノレポや framework 固有のビルドでは、netlify-deploy for Deployment の場面で重要です。

コマンドだけでなく、初回デプロイの形を求める

よりよい結果を得るには、1 行のコマンドだけでなく、手順の流れまで含む出力を求めるのが有効です。たとえば:
「このリポジトリを認証し、リンクし、netlify.toml を確認して、本番にデプロイするまでの正確な手順を示してください。」

こうすると、デプロイコマンドを実行する前に重要な判断ポイントを説明させやすくなります。

最初のデプロイ結果をもとに反復する

初回デプロイが失敗したら、最初から聞き直すのではなく、具体的な失敗内容と現在のファイル構成を返してください。特に有用なのは次の情報です。

• npx netlify のエラーメッセージ
• netlify.toml の内容
• フレームワークが実際に生成したビルド出力フォルダ
• 失敗前にサイトがリンク済みだったかどうか

これにより、次の netlify-deploy usage のステップがより正確になり、すでに成功している認証やリンクをやり直さずに済みます。