Vercel deploy skill

Deploy applications and websites to Vercel.

by bytedance·MIT license·★ 83,533 Stars on the repo·GitHub ↗

Use now

bytedance/main1 file shown

SKILL.md3.1 KB

Browse every file on GitHub↗

SKILL.md

Show the full text113 lines

vercel-deploy/SKILL.md113 lines · 3.1 KB

PreviewCode

Outline

RawView on GitHub

Vercel Deploy

Deploy any project to Vercel instantly. No authentication required.

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)

Usage

bash /mnt/skills/public/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/public/vercel-deploy/scripts/deploy.sh

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

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

Output

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

The script also outputs JSON to stdout for programmatic use:

{
  "previewUrl": "https://skill-deploy-abc123.vercel.app",
  "claimUrl": "https://vercel.com/claim-deployment?code=...",
  "deploymentId": "dpl_...",
  "projectId": "prj_..."
}

Framework Detection

The script auto-detects frameworks from package.json. Supported frameworks include:

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.

For static HTML projects (no package.json), framework is set to null.

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 Restriction 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

1	---
2	name: vercel-deploy
3	description: 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.
4	metadata:
5	author: vercel
6	version: "1.0.0"
7	---
8
9	# Vercel Deploy
10
11	Deploy any project to Vercel instantly. No authentication required.
12
13	## How It Works
14
15	1. Packages your project into a tarball (excludes `node_modules` and `.git`)
16	2. Auto-detects framework from `package.json`
17	3. Uploads to deployment service
18	4. Returns Preview URL (live site) and Claim URL (transfer to your Vercel account)
19
20	## Usage
21
22	```bash
23	bash /mnt/skills/public/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
33	bash /mnt/skills/public/vercel-deploy/scripts/deploy.sh
34
35	# Deploy specific project
36	bash /mnt/skills/public/vercel-deploy/scripts/deploy.sh /path/to/project
37
38	# Deploy existing tarball
39	bash /mnt/skills/public/vercel-deploy/scripts/deploy.sh /path/to/project.tgz
40	```
41
42	## Output
43
44	```
45	Preparing deployment...
46	Detected framework: nextjs
47	Creating deployment package...
48	Deploying...
49	✓ Deployment successful!
50
51	Preview URL: https://skill-deploy-abc123.vercel.app
52	Claim URL: https://vercel.com/claim-deployment?code=...
53	```
54
55	The 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
68	The 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
78	For static HTML projects (no `package.json`), framework is set to `null`.
79
80	## Static HTML Projects
81
82	For 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
88	Always show both URLs:
89
90	```
91	✓ Deployment successful!
92
93	- [Preview URL](https://skill-deploy-abc123.vercel.app)
94	- [Claim URL](https://vercel.com/claim-deployment?code=...)
95
96	View your site at the Preview URL.
97	To transfer this deployment to your Vercel account, visit the Claim URL.
98	```
99
100	## Troubleshooting
101
102	### Network Restriction Error
103
104	If deployment fails due to network restrictions (common on claude.ai), tell the user:
105
106	```
107	Deployment failed due to network restrictions. To fix this:
108
109	1. Go to https://claude.ai/settings/capabilities
110	2. Add *.vercel.com to the allowed domains
111	3. Try deploying again
112	```
113