vercel-deploy について
vercel-deployは、プロジェクトをパッケージ化してVercelへデプロイするスキルです。プレビューURLと引き継ぎ用URLを返し、ディレクトリや既存の圧縮ファイルからログイン前にデプロイできます。
主な機能
- 01ディレクトリまたは.tgzのデプロイ
- 02node_modulesと.gitの除外
- 03package.jsonからのフレームワーク検出
- 04単一ファイルの静的HTML処理
- 05URLとJSON出力
活用シーン
- 01プロジェクトのVercelプレビュー作成
- 02既存のプロジェクト圧縮ファイルのデプロイ
- 03静的HTMLページの公開
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ vercel-labs/ vercel-deploy-codex-skill --skill vercel-deployインストール後、Claude Code で/vercel-deployを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
openai.yamlassets/vercel.svgscripts/deploy.sh詳細
Vercel Deploy
あらゆるプロジェクトを Vercel にすぐにデプロイできます。認証は不要です。
仕組み
- プロジェクトを
.tar.gzにパッケージ化します(node_modulesと.gitは除外されます) package.jsonからフレームワークを自動検出します- デプロイサービスにアップロードします
- プレビュー 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
コメント
Markdown 対応