Install and configure Vercel SDK/CLI authentication. Use when setting up a new Vercel integration, configuring API keys, or initializing Vercel in your project. Trigger with phrases like "install vercel", "setup vercel", "vercel auth", "configure vercel API key".
npxskills add jeremylongshore/claude-code-plugins-plus-skills--skill vercel-install-authLoading…
Install the Vercel CLI, create a scoped access token, and link your local project to a Vercel project. This skill covers both interactive login and headless CI token authentication via the REST API.
set -euo pipefail
# Global install (recommended)
npm install -g vercel@latest
# Or project-local
npm install --save-dev vercel@latest
# Verify installation
vercel --version
# Opens browser for OAuth login, stores token in ~/.config/com.vercel.cli
vercel login
# Or login with a specific email
vercel login [email protected]
# Login with GitHub
vercel login --github
# Login with GitLab
vercel login --gitlab
Create a token in the Vercel dashboard at Settings > Tokens or via the API:
# Use a pre-created token — set as environment variable
export VERCEL_TOKEN="your-access-token-here"
# The CLI reads VERCEL_TOKEN automatically — no login needed
vercel whoami
# Output: your-username
# Scope the token to a specific team
export VERCEL_ORG_ID="team_xxxxxxxxxxxx"
export VERCEL_PROJECT_ID="prj_xxxxxxxxxxxx"
# Interactive — walks you through project selection
vercel link
# Or link to a specific project by name
vercel link --project my-project-name
# Verify the link — pulls .vercel/project.json
cat .vercel/project.json
# {"orgId":"team_xxx","projectId":"prj_xxx"}
# Test token against the REST API directly
curl -s -H "Authorization: Bearer $VERCEL_TOKEN" \
https://api.vercel.com/v9/projects | jq '.projects[].name'
# List teams
curl -s -H "Authorization: Bearer $VERCEL_TOKEN" \
https://api.vercel.com/v2/teams | jq '.teams[].name'
# Pull remote env vars to local .env.development.local
vercel env pull .env.development.local
# Pull for a specific environment
vercel env pull --environment=preview
| Scope | Access | Use Case |
|---|---|---|
| Full Account | All projects, all teams | Personal dev |
| Team-scoped | One team only | Team CI/CD |
| Project-scoped | One project only | Per-project automation |
Tokens support optional expiration dates. Set short-lived tokens (90 days) for CI and rotate them on a schedule.
.vercel/project.json.env.development.local| Error | Cause | Solution |
|---|---|---|
Error: No token found | Not logged in, no VERCEL_TOKEN | Run vercel login or export VERCEL_TOKEN |
Error: Invalid token | Token expired or revoked | Generate new token at vercel.com/account/tokens |
EACCES permission denied | Global install without sudo | Use npx vercel or install with --prefix ~/.npm-global |
Error: Team not found | Wrong VERCEL_ORG_ID | Check team ID in Vercel dashboard > Settings > General |
fetch failed | Network or proxy issue | Check HTTPS_PROXY env var, ensure port 443 outbound |
.gitignore Setup# Vercel
.vercel/
.env*.local
After successful auth, proceed to vercel-hello-world for your first deployment.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).