deploy-to-vercel

Deploy projects to Vercel via CLI, git push, or claimable upload scripts.

Updated Jul 25, 2026
One-click install
npx skills add https://github.com/regisleandro/clara-financas --skill deploy-to-vercel-regisleandro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deploy-to-vercel
Source: https://github.com/regisleandro/clara-financas/tree/main/.agents/skills/deploy-to-vercel
Command: npx skills add https://github.com/regisleandro/clara-financas --skill deploy-to-vercel-regisleandro

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Getting a local project live on Vercel involves several decisions: whether the project is linked, whether the CLI is authenticated, which team to target, and what to do in sandboxed environments without credentials. This Skill walks through that decision tree and executes the right deployment path, always defaulting to preview deployments unless production is explicitly requested. ## Core Features & Use Cases - State-aware deployment flow: Checks git remotes, .vercel/project.json or .vercel/repo.json linkage, and CLI authentication before choosing between git push, vercel deploy, or linking first. - Team and scope handling: Lists available Vercel teams and passes the selected slug via --scope on all CLI commands. - No-auth fallback scripts: Ships deploy.sh and deploy-codex.sh that detect the framework from package.json, package the project excluding node_modules and .env, upload to a claimable deploy endpoint, and return preview and claim URLs. - Use Case: You have an unlinked Next.js app in a sandboxed environment with no Vercel credentials. The Skill runs the fallback script, waits for the build, and returns a live preview URL plus a claim URL to transfer the deployment to your account. ## Quick Start Deploy my current project to Vercel and give me the preview link.

Frequently Asked Questions about deploy-to-vercel

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy my app to Vercel from the command line?

Run vercel deploy with the -y and --no-wait flags to get a deployment URL immediately without blocking on the build. If the project is linked to a git remote, committing and pushing triggers an automatic deployment instead.

How do I deploy to Vercel without logging in?

Use the claimable deploy script, which packages the project into a tarball excluding node_modules and .env, uploads it to a deploy endpoint, and returns a preview URL plus a claim URL. The claim URL transfers the deployment to your Vercel account later.

How do I choose which Vercel team to deploy to?

Run vercel teams list --format json to see available teams, then pass the chosen slug with --scope on vercel deploy, vercel link, and vercel inspect commands. If the project is already linked, the orgId in .vercel/project.json determines the team.

Does the deploy script support frameworks other than Next.js?

Yes, the script detects frameworks from package.json dependencies, including Next.js, Remix, Astro, SvelteKit, Nuxt, Gatsby, Angular, Express, Fastify, Hono, and many others. Static HTML projects without package.json are also supported.

Why does Vercel deployment fail in a sandboxed environment?

Sandboxed environments often block network access or lack CLI credentials, causing timeouts or auth errors. Rerun the deploy command with escalated network permissions, or fall back to the no-auth deploy script that requires no credentials.

When should I use vercel link --repo instead of vercel link?

Use vercel link --repo when a git remote exists, because it matches the remote URL to existing Vercel projects and creates .vercel/repo.json. Plain vercel link matches by directory name, which often fails when local and project names differ.