Vercel Deploy

1---
2name: vercel-deploy
3description: Deploy applications and websites to Vercel. Use this skill when the user requests deployment actions such as "Deploy my app", "Deploy this to production", "Create a preview deployment", "Deploy and give me the link", or "Push this live". No authentication required - returns preview URL and claimable deployment link.
4metadata:
5  author: vercel
6  version: "1.0.0"
7---
8 
9# Vercel Deploy
10 
11Deploy any project to Vercel instantly. No authentication required.
12 
13## How It Works
14 
151. Packages your project into a tarball (excludes `node_modules` and `.git`)
162. Auto-detects framework from `package.json`
173. Uploads to deployment service
184. Returns **Preview URL** (live site) and **Claim URL** (transfer to your Vercel account)
19 
20## Usage
21 
22```bash
23bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh [path]
24```
25 
26**Arguments:**
27- `path` - Directory to deploy, or a `.tgz` file (defaults to current directory)
28 
29**Examples:**
30 
31```bash
32# Deploy current directory
33bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh
34 
35# Deploy specific project
36bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh /path/to/project
37 
38# Deploy existing tarball
39bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh /path/to/project.tgz
40```
41 
42## Output
43 
44```
45Preparing deployment...
46Detected framework: nextjs
47Creating deployment package...
48Deploying...
49✓ Deployment successful!
50 
51Preview URL: https://skill-deploy-abc123.vercel.app
52Claim URL:   https://vercel.com/claim-deployment?code=...
53```
54 
55The script also outputs JSON to stdout for programmatic use:
56 
57```json
58{
59  "previewUrl": "https://skill-deploy-abc123.vercel.app",
60  "claimUrl": "https://vercel.com/claim-deployment?code=...",
61  "deploymentId": "dpl_...",
62  "projectId": "prj_..."
63}
64```
65 
66## Framework Detection
67 
68The script auto-detects frameworks from `package.json`. Supported frameworks include:
69 
70- **React**: Next.js, Gatsby, Create React App, Remix, React Router
71- **Vue**: Nuxt, Vitepress, Vuepress, Gridsome
72- **Svelte**: SvelteKit, Svelte, Sapper
73- **Other Frontend**: Astro, Solid Start, Angular, Ember, Preact, Docusaurus
74- **Backend**: Express, Hono, Fastify, NestJS, Elysia, h3, Nitro
75- **Build Tools**: Vite, Parcel
76- **And more**: Blitz, Hydrogen, RedwoodJS, Storybook, Sanity, etc.
77 
78For static HTML projects (no `package.json`), framework is set to `null`.
79 
80## Static HTML Projects
81 
82For projects without a `package.json`:
83- If there's a single `.html` file not named `index.html`, it gets renamed automatically
84- This ensures the page is served at the root URL (`/`)
85 
86## Present Results to User
87 
88Always show both URLs:
89 
90```
91✓ Deployment successful!
92 
93Preview URL: https://skill-deploy-abc123.vercel.app
94Claim URL:   https://vercel.com/claim-deployment?code=...
95 
96View your site at the Preview URL.
97To transfer this deployment to your Vercel account, visit the Claim URL.
98```
99 
100## Troubleshooting
101 
102### Network Egress Error
103 
104If deployment fails due to network restrictions (common on claude.ai), tell the user:
105 
106```
107Deployment failed due to network restrictions. To fix this:
108 
1091. Go to https://claude.ai/settings/capabilities
1102. Add *.vercel.com to the allowed domains
1113. Try deploying again
112```
113