Vercel Deploy

Deploy any project to Vercel instantly. No authentication required.

When to use this skill

앱 배포: "Deploy my app" 요청 시
프리뷰 배포: "Create a preview deployment" 요청 시
프로덕션 배포: "Deploy this to production" 요청 시
링크 공유: "Deploy and give me the link" 요청 시

How It Works

Packages your project into a tarball (excludes node_modules and .git)
Auto-detects framework from package.json
Uploads to deployment service
Returns Preview URL (live site) and Claim URL (transfer to your Vercel account)

Instructions

Step 1: 프로젝트 준비

배포할 프로젝트 디렉토리를 확인합니다.

지원 프레임워크:

React: Next.js, Gatsby, Create React App, Remix, React Router
Vue: Nuxt, Vitepress, Vuepress, Gridsome
Svelte: SvelteKit, Svelte, Sapper
Other Frontend: Astro, Solid Start, Angular, Ember, Preact, Docusaurus
Backend: Express, Hono, Fastify, NestJS, Elysia, h3, Nitro
Build Tools: Vite, Parcel
And more: Blitz, Hydrogen, RedwoodJS, Storybook, Sanity, etc.

Step 2: 배포 실행

스크립트 사용 (claude.ai 환경):

bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh [path]

Arguments:

path - Directory to deploy, or a .tgz file (defaults to current directory)

Examples:

# Deploy current directory
bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh

# Deploy specific project
bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh /path/to/project

# Deploy existing tarball
bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh /path/to/project.tgz

Step 3: 결과 확인

배포 성공 시 두 개의 URL이 반환됩니다:

Preview URL: 즉시 접근 가능한 라이브 사이트
Claim URL: Vercel 계정으로 배포 이전

Output Format

콘솔 출력

Preparing deployment...
Detected framework: nextjs
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_..."
}

Static HTML Projects

For projects without a package.json:

If there's a single .html file not named index.html, it gets renamed automatically
This ensures the page is served at the root URL (/)

Present Results to User

Always show both URLs:

✓ 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.

Troubleshooting

Network Egress Error

If deployment fails due to network restrictions (common on claude.ai), tell the user:

Deployment failed due to network restrictions. To fix this:

1. Go to https://claude.ai/settings/capabilities
2. Add *.vercel.com to the allowed domains
3. Try deploying again

Framework Not Detected

프레임워크가 감지되지 않으면:

package.json 존재 여부 확인
dependencies에 프레임워크 패키지 포함 확인
수동으로 framework 파라미터 지정

Constraints

필수 규칙 (MUST)

두 URL 모두 표시: Preview URL과 Claim URL 모두 사용자에게 표시
프레임워크 감지: package.json에서 자동 감지
에러 메시지 표시: 배포 실패 시 명확한 에러 메시지

vercel-deploy