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에서 자동 감지
- 에러 메시지 표시: 배포 실패 시 명확한 에러 메시지
금지 사항 (MUST NOT)
- node_modules 포함: tarball에 node_modules 포함하지 않음
- .git 포함: tarball에 .git 디렉토리 포함하지 않음
- 인증 정보 하드코딩: 인증 필요 없음 (claimable deploy)
Best practices
- 프레임워크 자동 감지: package.json 분석으로 최적 설정
- Clean Tarball: node_modules, .git 제외로 빠른 업로드
- 명확한 출력: Preview URL과 Claim URL 구분 표시
References
Metadata
버전
- 현재 버전: 1.0.0
- 최종 업데이트: 2026-01-22
- 호환 플랫폼: Claude (claude.ai)
- 원본 출처: vercel/agent-skills
관련 스킬
태그
#deployment #vercel #preview #production #hosting #serverless #infrastructure
1---2name: vercel-deploy-33description: Deploy applications and websites to Vercel instantly. Use when asked to "Deploy my app", "Deploy this to production", "Create a preview deployment", or "Push this live". No authentication required - returns preview URL and claimable deployment link.4---5
6# Vercel Deploy
7
8Deploy any project to Vercel instantly. No authentication required.
9
10## When to use this skill
11
12- **앱 배포**: "Deploy my app" 요청 시
13- **프리뷰 배포**: "Create a preview deployment" 요청 시
14- **프로덕션 배포**: "Deploy this to production" 요청 시
15- **링크 공유**: "Deploy and give me the link" 요청 시
16
17## How It Works
18
191. Packages your project into a tarball (excludes `node_modules` and `.git`)
202. Auto-detects framework from `package.json`
213. Uploads to deployment service
224. Returns **Preview URL** (live site) and **Claim URL** (transfer to your Vercel account)
23
24## Instructions
25
26### Step 1: 프로젝트 준비
27
28배포할 프로젝트 디렉토리를 확인합니다.
29
30**지원 프레임워크**:
31- **React**: Next.js, Gatsby, Create React App, Remix, React Router
32- **Vue**: Nuxt, Vitepress, Vuepress, Gridsome
33- **Svelte**: SvelteKit, Svelte, Sapper
34- **Other Frontend**: Astro, Solid Start, Angular, Ember, Preact, Docusaurus
35- **Backend**: Express, Hono, Fastify, NestJS, Elysia, h3, Nitro
36- **Build Tools**: Vite, Parcel
37- **And more**: Blitz, Hydrogen, RedwoodJS, Storybook, Sanity, etc.
38
39### Step 2: 배포 실행
40
41**스크립트 사용** (claude.ai 환경):
42```bash
43bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh [path]
44```
45
46**Arguments:**
47- `path` - Directory to deploy, or a `.tgz` file (defaults to current directory)
48
49**Examples:**
50```bash
51# Deploy current directory
52bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh
53
54# Deploy specific project
55bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh /path/to/project
56
57# Deploy existing tarball
58bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh /path/to/project.tgz
59```
60
61### Step 3: 결과 확인
62
63배포 성공 시 두 개의 URL이 반환됩니다:
64- **Preview URL**: 즉시 접근 가능한 라이브 사이트
65- **Claim URL**: Vercel 계정으로 배포 이전
66
67## Output Format
68
69### 콘솔 출력
70
71```
72Preparing deployment...
73Detected framework: nextjs
74Creating deployment package...
75Deploying...
76✓ Deployment successful!
77
78Preview URL: https://skill-deploy-abc123.vercel.app
79Claim URL: https://vercel.com/claim-deployment?code=...
80```
81
82### JSON 출력 (프로그래밍 용)
83
84```json
85{
86 "previewUrl": "https://skill-deploy-abc123.vercel.app",
87 "claimUrl": "https://vercel.com/claim-deployment?code=...",
88 "deploymentId": "dpl_...",
89 "projectId": "prj_..."
90}
91```
92
93## Static HTML Projects
94
95For projects without a `package.json`:
96- If there's a single `.html` file not named `index.html`, it gets renamed automatically
97- This ensures the page is served at the root URL (`/`)
98
99## Present Results to User
100
101Always show both URLs:
102
103```
104✓ Deployment successful!
105
106Preview URL: https://skill-deploy-abc123.vercel.app
107Claim URL: https://vercel.com/claim-deployment?code=...
108
109View your site at the Preview URL.
110To transfer this deployment to your Vercel account, visit the Claim URL.
111```
112
113## Troubleshooting
114
115### Network Egress Error
116
117If deployment fails due to network restrictions (common on claude.ai), tell the user:
118
119```
120Deployment failed due to network restrictions. To fix this:
121
1221. Go to https://claude.ai/settings/capabilities
1232. Add *.vercel.com to the allowed domains
1243. Try deploying again
125```
126
127### Framework Not Detected
128
129프레임워크가 감지되지 않으면:
1301. `package.json` 존재 여부 확인
1312. dependencies에 프레임워크 패키지 포함 확인
1323. 수동으로 `framework` 파라미터 지정
133
134## Constraints
135
136### 필수 규칙 (MUST)
137
1381. **두 URL 모두 표시**: Preview URL과 Claim URL 모두 사용자에게 표시
1392. **프레임워크 감지**: package.json에서 자동 감지
1403. **에러 메시지 표시**: 배포 실패 시 명확한 에러 메시지
141
142### 금지 사항 (MUST NOT)
143
1441. **node_modules 포함**: tarball에 node_modules 포함하지 않음
1452. **.git 포함**: tarball에 .git 디렉토리 포함하지 않음
1463. **인증 정보 하드코딩**: 인증 필요 없음 (claimable deploy)
147
148## Best practices
149
1501. **프레임워크 자동 감지**: package.json 분석으로 최적 설정
1512. **Clean Tarball**: node_modules, .git 제외로 빠른 업로드
1523. **명확한 출력**: Preview URL과 Claim URL 구분 표시
153
154## References
155
156- [Vercel Documentation](https://vercel.com/docs)
157- [Vercel CLI](https://vercel.com/docs/cli)
158
159## Metadata
160
161### 버전
162- **현재 버전**: 1.0.0
163- **최종 업데이트**: 2026-01-22
164- **호환 플랫폼**: Claude (claude.ai)
165- **원본 출처**: vercel/agent-skills
166
167### 관련 스킬
168- [deployment-automation](../deployment-automation/SKILL.md): CI/CD 및 Docker/K8s 배포
169
170### 태그
171`#deployment` `#vercel` `#preview` `#production` `#hosting` `#serverless` `#infrastructure`
diegosouzapw