deploy-to-vercel

Deploy projects to Vercel via CLI, git push, or claimable no-auth deploy scripts.

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill deploy-to-vercel-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deploy-to-vercel
Source: https://github.com/surfingalien/FinSurfing/tree/main/Downloads/FinSurfing/.agents/skills/deploy-to-vercel
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill deploy-to-vercel-surfingalien

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Getting a local project live on Vercel involves many branching paths: checking git remotes, verifying CLI authentication, linking projects to teams, and handling sandboxed environments where login is impossible. This Skill automates that decision flow and always returns a working deployment URL. ## Core Features & Use Cases - State-aware deploy routing: Detects git remotes, existing .vercel/ project links, and CLI authentication status, then picks the right method (git push, vercel deploy, or fallback script). - Team and project linking: Prompts for team selection when multiple Vercel teams exist and links the project with vercel link --repo or standard linking to enable future git-push deployments. - No-auth fallback scripts: Ships deploy.sh and deploy-codex.sh that package a project (excluding node_modules, .git, .env), auto-detect 40+ frameworks from package.json, upload to a claimable deploy endpoint, and poll until the build completes. - Use Case: You are in a sandboxed AI environment with no Vercel credentials and want a live preview link for your React app. The Skill runs the fallback script and returns a 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 after authenticating with vercel login. If the project is linked to a git remote, committing and pushing also triggers an automatic Vercel deployment.

How do I deploy to Vercel without authentication?

Use the included deploy.sh or deploy-codex.sh fallback scripts, which package your project, detect the framework from package.json, and upload it to a claimable deploy endpoint. They return a preview URL and a claim URL to transfer the deployment to your Vercel account.

How do I deploy to a specific Vercel team?

List teams with vercel teams list --format json, then pass the chosen team slug via the --scope flag on vercel deploy, vercel link, and vercel inspect commands. Already-linked projects use the orgId stored in .vercel/project.json or .vercel/repo.json.

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

Yes, the scripts detect over 40 frameworks from package.json dependencies, including Remix, Astro, SvelteKit, Nuxt, Vite, Express, Fastify, and Hono. Static HTML projects without package.json are also supported, with a single HTML file renamed to index.html.

Why does Vercel deployment fail in a sandboxed environment?

Sandboxes like claude.ai or Codex may block network egress or prevent vercel login. Add *.vercel.com to allowed domains, rerun with escalated network permissions, or fall back to the no-auth deploy script.