# Vercel에 배포 (deploy-to-vercel)

> Vercel 연결 여부, git 원격, CLI 인증 상태에 따라 방법을 골라 앱을 Vercel에 배포하고 링크를 돌려줍니다.

- 카테고리: [배포·릴리스](https://www.myskills.tools/ko/categories/deploy-release/)
- 출처: 공식 · Vercel Labs
- 저장소: https://github.com/vercel-labs/agent-skills/tree/main/skills/deploy-to-vercel (commit dfeeb54 · v4.0.0)
- SKILL.md: https://github.com/vercel-labs/agent-skills/blob/main/skills/deploy-to-vercel/SKILL.md
- 설치 명령: `npx skills add vercel-labs/agent-skills --skill deploy-to-vercel`
- 라이선스: MIT
- 호환 도구: Any SKILL.md agent
- 권한: read-repo ✓, write-files ✓, shell ✓, network ✓
- 상태: 스캔 통과
- 규칙 스캔으로 모든 위험을 찾을 수는 없습니다. 설치 전에 이 스킬의 SKILL.md를 읽고 권한을 확인하세요.
- ⚠ 코드를 Vercel에 배포하며, 승인 후 git add .로 커밋·푸시할 수 있고 Vercel CLI를 전역 설치할 수도 있습니다.

## 핵심 규칙

사용자가 운영 배포를 명시하지 않으면 항상 프리뷰로 배포합니다.

## 실행 단계

1. **프로젝트 상태 확인** — git 원격, .vercel/ 연결 파일, vercel whoami 인증 상태, 사용 가능한 팀 목록을 확인합니다.
2. **팀 선택** — 팀이 여러 개면 사용자에게 고르게 하고 이후 명령에 --scope를 붙입니다. 이미 연결됐거나 팀이 하나면 건너뜁니다.
3. **연결 후 배포** — 연결되어 있고 원격이 있으면 승인 후 커밋·푸시하고, 아니면 vercel link 후 vercel deploy를 실행합니다. 필요하면 CLI를 설치하고 로그인합니다.
4. **비인증 대안** — 로그인할 수 없으면 vercel deploy --temporary로 임시 배포하고 클레임 URL과 만료 시간을 알려 줍니다.
5. **배포 링크 전달** — vercel ls나 vercel inspect로 링크와 빌드 상태를 얻어 알려 주며, curl로 배포 주소를 확인하지 않습니다.

## 권한 설명 (SKILL.md 기준)

| 기능 | 필요 여부 | 설명 |
|---|---|---|
| 파일 쓰기 | 일부 필요 | vercel link로 .vercel/ 연결 파일을 만들고, git 푸시 배포 시 현재 변경을 커밋합니다. 앱 코드는 편집하지 않습니다. |
| 명령 실행 | 필요 | git, vercel CLI(whoami, link, deploy, inspect, ls), npm install -g vercel 또는 npx vercel을 실행합니다. |
| 네트워크 송신 | 일부 필요 | Vercel, npm 레지스트리, git 원격에만 연결하며 배포된 URL로 확인 요청을 보내지 않습니다. |

## SKILL.md 프런트매터(YAML)

```yaml
---
name: deploy-to-vercel
description: Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".
metadata:
  author: vercel
  version: "4.0.0"
---
```

홈: https://www.myskills.tools/ko/ · URL: https://www.myskills.tools/ko/skills/deploy-to-vercel/