Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
vercel-labs avatar

Vercel Deploy

  • 58 installs
  • 3 repo stars
  • Updated January 30, 2026
  • vercel-labs/vercel-deploy-codex-skill

vercel-deploy is an agent skill that deploys projects to Vercel with claimable preview URLs requiring no authentication.

About

The vercel-deploy skill deploys any project to Vercel instantly without authentication by packaging the directory into a tar.gz excluding node_modules and .git, auto-detecting the framework from package.json, uploading to the deployment service, and returning both a live Preview URL and a Claim URL to transfer ownership to the user's Vercel account. Usage runs bash scripts/deploy.sh with an optional path argument for a directory or existing tgz archive. Framework detection covers React stacks like Next.js and Remix, Vue frameworks, SvelteKit, Astro, backend frameworks including Express and NestJS, and many others, while static HTML projects without package.json set framework to null and rename a single HTML file to index.html for root serving. Output includes human-readable success messages plus JSON with previewUrl, claimUrl, deploymentId, and projectId for programmatic consumption. Present results must always show both URLs so users can view the preview immediately and claim the deployment later. Troubleshooting covers network egress errors by advising outbound access to vercel.com domains.

  • Deploys without Vercel authentication via scripts/deploy.sh.
  • Returns live Preview URL and account Claim URL for transfer.
  • Auto-detects frameworks from package.json across major stacks.
  • Packages projects excluding node_modules and .git automatically.
  • Outputs JSON with previewUrl, claimUrl, deploymentId, and projectId.

Vercel Deploy by the numbers

  • 58 all-time installs (skills.sh)
  • +3 installs in the week ending Jul 27, 2026 (Skillselion tracking)
  • Ranked #664 of 1,453 DevOps & CI/CD skills by installs in the Skillselion catalog
  • Security screen: CRITICAL risk (skills.sh audit)
  • Data as of Jul 27, 2026 (Skillselion catalog sync)
At a glance

vercel-deploy capabilities & compatibility

Capabilities
tar.gz packaging excluding node_modules and git · framework auto detection from package.json · preview and claim url generation · static html index.html rename handling · json programmatic deployment output
Works with
vercel
Use cases
devops · ci cd
From the docs

What vercel-deploy says it does

Deploy any project to Vercel instantly. No authentication required.
SKILL.md
npx skills add https://github.com/vercel-labs/vercel-deploy-codex-skill --skill vercel-deploy

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs58
repo stars3
Security audit2 / 3 scanners passed
Last updatedJanuary 30, 2026
Repositoryvercel-labs/vercel-deploy-codex-skill

How do I deploy my app to Vercel and get a live preview link without setting up auth first?

Deploy applications and websites to Vercel with a claimable preview URL and no authentication required.

Who is it for?

Developers who need instant Vercel preview deployments with framework auto-detection and claimable transfer.

Skip if: Skip when you need production account-linked deploys with existing Vercel project configuration and secrets.

When should I use this skill?

User asks to deploy my app, push this live, create a preview deployment, or deploy and give me the link.

What you get

A live Vercel preview URL plus a claim URL to transfer the deployment to your account.

Files

SKILL.mdMarkdownGitHub ↗

Vercel Deploy

Deploy any project to Vercel instantly. No authentication required.

How It Works

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

Usage

bash scripts/deploy.sh [path]

Arguments:

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

If you pass a directory, the script will create a .tar.gz before upload.

Examples:

# Deploy current directory
bash scripts/deploy.sh

# Deploy specific project
bash scripts/deploy.sh /path/to/project

# Deploy existing tarball
bash scripts/deploy.sh /path/to/project.tgz

Packaging Rules

  • Exclude node_modules and .git
  • If no package.json, keep framework as null
  • For static HTML with a single .html file, rename it to index.html before packaging

Output

Preparing deployment...
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 Egress Error

If deployment fails due to network restrictions, tell the user:

Deployment failed due to network restrictions. To fix this:

1. Allow outbound access to *.vercel.com
2. Try deploying again

Related skills

FAQ

What does vercel-deploy produce?

A live Preview URL, a Claim URL for account transfer, and JSON with deployment and project identifiers.

When should I use vercel-deploy?

When you want an instant Vercel preview deployment without authentication setup.

Is vercel-deploy safe to install?

Review the Security Audits panel on this page before installing in production.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.