mcpField
V
vercel-deploy

vercel-deploy

github.com/vercel-labsクラウド・DevOps572 回インストール39 週間前に更新
リポジトリ

vercel-deploy について

vercel-deployは、プロジェクトをパッケージ化してVercelへデプロイするスキルです。プレビューURLと引き継ぎ用URLを返し、ディレクトリや既存の圧縮ファイルからログイン前にデプロイできます。

主な機能

  1. 01ディレクトリまたは.tgzのデプロイ
  2. 02node_modulesと.gitの除外
  3. 03package.jsonからのフレームワーク検出
  4. 04単一ファイルの静的HTML処理
  5. 05URLとJSON出力

活用シーン

  1. 01プロジェクトのVercelプレビュー作成
  2. 02既存のプロジェクト圧縮ファイルのデプロイ
  3. 03静的HTMLページの公開

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/vercel-labs/vercel-deploy-codex-skill --skill vercel-deploy

インストール後、Claude Code で/vercel-deployを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

openai.yaml
assets/
vercel.svg
scripts/
deploy.sh

詳細

Vercel Deploy

あらゆるプロジェクトを Vercel にすぐにデプロイできます。認証は不要です。

仕組み

  1. プロジェクトを .tar.gz にパッケージ化します(node_modules と .git は除外されます)
  2. package.json からフレームワークを自動検出します
  3. デプロイサービスにアップロードします
  4. プレビュー URL(公開中のサイト)と Claim URL(Vercel アカウントへの移管用)を返します

使用方法

bash scripts/deploy.sh [path]

引数:

  • path - デプロイするディレクトリ、または .tgz ファイル(デフォルトは現在のディレクトリ)

ディレクトリを指定すると、スクリプトはアップロード前に .tar.gz を作成します。

例:

# Deploy current directory
bash scripts/deploy.sh

# Deploy specific project
bash scripts/deploy.sh /path/to/project

# Deploy existing tarball
bash scripts/deploy.sh /path/to/project.tgz

パッケージ化のルール

  • node_modules と .git は除外します
  • package.json がない場合、framework は null のままにします
  • 単一の .html ファイルで構成される静的 HTML の場合、パッケージ化する前にファイル名を index.html に変更します

出力

Preparing deployment...
Creating deployment package...
Deploying...
✓ Deployment successful!

Preview URL: https://skill-deploy-abc123.vercel.app
Claim URL:   https://vercel.com/claim-deployment?code=...

スクリプトはプログラムから利用できるよう、JSON も標準出力に出力します。

{
  "previewUrl": "https://skill-deploy-abc123.vercel.app",
  "claimUrl": "https://vercel.com/claim-deployment?code=...",
  "deploymentId": "dpl_...",
  "projectId": "prj_..."
}

フレームワークの検出

スクリプトは package.json からフレームワークを自動検出します。対応しているフレームワークは次のとおりです。

  • React: Next.js、Gatsby、Create React App、Remix、React Router
  • Vue: Nuxt、Vitepress、Vuepress、Gridsome
  • Svelte: SvelteKit、Svelte、Sapper
  • その他のフロントエンド: Astro、Solid Start、Angular、Ember、Preact、Docusaurus
  • バックエンド: Express、Hono、Fastify、NestJS、Elysia、h3、Nitro
  • ビルドツール: Vite、Parcel
  • その他: Blitz、Hydrogen、RedwoodJS、Storybook、Sanity など

静的 HTML プロジェクト(package.json なし)の場合、framework は null に設定されます。

静的 HTML プロジェクト

package.json がないプロジェクトの場合:

  • index.html という名前ではない .html ファイルが 1 つだけある場合、自動的にファイル名が変更されます
  • これにより、ルート URL(/)でページが配信されます

結果をユーザーに提示する

必ず両方の URL を表示してください。

✓ Deployment successful!

Preview URL: https://skill-deploy-abc123.vercel.app
Claim URL:   https://vercel.com/claim-deployment?code=...

View your site at the Preview URL.
To transfer this deployment to your Vercel account, visit the Claim URL.

トラブルシューティング

ネットワークの送信エラー

ネットワークの制限によりデプロイに失敗した場合は、ユーザーに次のように伝えてください。

Deployment failed due to network restrictions. To fix this:

1. Allow outbound access to *.vercel.com
2. Try deploying again

コメント