Agent skill

Vercel CLI

by nanocoai in nanocoai/nanoclaw

Deploy apps to Vercel. An agent skill from nanocoai/nanoclaw.

MITAuto-check: warningsDevOps & Cloud

Install Vercel CLI

The automated check flagged lines worth reading first. See the safety section below.

skills CLI
$ npx skills add nanocoai/nanoclaw --skill vercel-cli -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install nanocoai/nanoclaw vercel-cli --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/nanocoai/nanoclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/add-vercel/container-skills/vercel-cli .claude/skills/vercel-cli && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
vercel-cli
GitHub stars
31k
Token cost
~1.4k tokens
SKILL.md length
622 words
Files
1
Skills in repo
59
Repo updated
First seen
Licence
MIT

At a glance

Deploy apps to Vercel. An agent skill from nanocoai/nanoclaw.

  • Works in 4 steps: Local build passes — run npm run build… → Deployment succeeded — the vercel deploy… → Live URL responds — curl -sI | head -1… → …
  • Asked to deploy
  • SKILL.md covers Auth, Deploying, Pre-Send Checks (do this… and Project Management, plus 5 more sections
  • Calls vercel, npm and curl

What it does

Vercel CLI is an agent skill from nanocoai/nanoclaw. Deploy apps to Vercel. Use when asked to deploy, ship, or publish a web application, or manage Vercel projects, domains, and environment variables.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud, covering Secrets management. It works with Vercel. The repository describes itself as: A lightweight alternative to OpenClaw that runs in containers for security. Connects to WhatsApp, Telegram, Slack, Discord, Gmail and other messaging apps,, has memory, scheduled…. The licence is MIT.

When your agent uses it

  • Asked to deploy
  • Publish a web application
  • Manage Vercel projects
  • Environment variables

Example prompts

  • “/vercel-cli”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Local build passes — run npm run build (or the project's build command) before vercel deploy. If the build fails locally, fix it first…
  2. Deployment succeeded — the vercel deploy output shows a "Production: https://..." URL and the status is READY (confirm with vercel inspect).
  3. Live URL responds — curl -sI | head -1 should return HTTP/2 200 (or another 2xx/3xx). A 404/500 means something's broken even though…
  4. Optional visual check — if agent-browser is loaded, open the URL and eyeball it. Helpful for catching broken layouts that a 200 response…

What it can do on your machine

Read from SKILL.md and the folder at commit 66f0823. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • vercel
    • npm
    • curl
    • pnpm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • vercel.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Vercel CLI loads about 1.4k tokens when it runs. Until then it costs about 40 tokens; SKILL.md has 622 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~40
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: warnings

The automated check found patterns that need a careful read before installing.

  • NoteMentions a .env fileSKILL.md:83
    # Pull env vars from Vercel to local .env
  • WarningContains instruction-override wording (e.g. “without asking the user”)SKILL.md:119
    has no work. You MUST send the message. Do NOT tell the user "it's working on it" until you have actually called send_me

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nanocoai/nanoclaw at commit 66f0823, republished under its MIT licence (© nanocoai). 622 words, ~1,444 tokens.

Download SKILL.mdSave it as .claude/skills/vercel-cli/SKILL.md (or your agent's skills folder).
name
vercel-cli
description
Deploy apps to Vercel. Use when asked to deploy, ship, or publish a web application, or manage Vercel projects, domains, and environment variables.

Vercel CLI

You can deploy web applications to Vercel using the vercel CLI.

HARD RULE: You MUST NOT write HTML, CSS, or JavaScript yourself. When asked to build a website or web app, you MUST delegate to a Frontend Engineer subagent (see "Building Websites" section below). This is not optional. Violation wastes your context window on code that belongs in a separate agent.

Auth

Auth is handled by OneCLI — the HTTPS_PROXY injects the real token into API requests automatically. The Vercel CLI requires a token to be present to skip its local credential check, so always pass --token placeholder on every command. OneCLI replaces this with the real token at the proxy level.

Before any Vercel operation, verify auth:

bash
vercel whoami --token placeholder

If this fails with an auth error, ask the user to add a Vercel token to OneCLI. They can create one at https://vercel.com/account/tokens and register it via onecli secrets create on the host. Once added, retry vercel whoami.

Deploying

Always use --yes to skip interactive prompts and --token placeholder for auth (OneCLI replaces with real token).

bash
# Deploy to production
vercel deploy --yes --prod --token placeholder

# Deploy from a specific directory
vercel deploy --yes --prod --token placeholder --cwd /path/to/project

# Preview deployment (not production)
vercel deploy --yes --token placeholder

After deploying, verify the live URL:

bash
# Check deployment status
vercel inspect <deployment-url> --token placeholder

Pre-Send Checks (do this before sharing the URL)

Don't send the deployment URL to the user until you've confirmed it's actually working. At minimum:

  1. Local build passes — run npm run build (or the project's build command) before vercel deploy. If the build fails locally, fix it first; don't deploy broken code.
  2. Deployment succeeded — the vercel deploy output shows a "Production: https://..." URL and the status is READY (confirm with vercel inspect).
  3. Live URL responds — curl -sI <url> | head -1 should return HTTP/2 200 (or another 2xx/3xx). A 404/500 means something's broken even though Vercel reported success.
  4. Optional visual check — if agent-browser is loaded, open the URL and eyeball it. Helpful for catching broken layouts that a 200 response wouldn't reveal.

If any check fails, fix the issue and redeploy before reporting to the user.

Project Management

bash
# Link to an existing Vercel project (non-interactive)
vercel link --yes --token placeholder

# List recent deployments
vercel ls --token placeholder

# List all projects
vercel project ls --token placeholder

Domains

bash
# List domains
vercel domains ls --token placeholder

# Add a domain to the current project
vercel domains add example.com --token placeholder

Environment Variables

bash
# Pull env vars from Vercel to local .env
vercel env pull --token placeholder

# Add an env var (use echo to pipe the value — avoids interactive prompt)
echo "value" | vercel env add VAR_NAME production --token placeholder

Common Errors

ErrorFix
Error: No framework detectedEnsure the project has a package.json with a build script, or set the framework in vercel.json
Error: Rate limitedWait and retry. Don't loop — report to user
Error: You have reached your project limitUser needs to upgrade Vercel plan or delete unused projects
ENOTFOUND api.vercel.comNetwork issue. Check proxy connectivity
Auth error after vercel whoamiCredential may be expired. Ask the user to refresh the Vercel token in OneCLI
Show full SKILL.md (220 more words)Show less

Building Websites — Delegate to Frontend Engineer

When asked to build, create, or redesign a website or web app, do NOT build it yourself. You MUST delegate to a Frontend Engineer agent. This is a two-step process and both steps are required:

Step 1 — Create the agent (skip if you already have a "frontend-engineer" destination):

create_agent({
  name: "Frontend Engineer",
  instructions: "You are a dedicated frontend engineer. Your frontend-engineer skill has your full workflow. Build what is requested, test it visually with agent-browser, deploy to Vercel, and send back the live URL + screenshots to your parent agent when done."
})

Step 2 — Send the build request (MANDATORY — do this immediately after step 1):

send_message(to: "frontend-engineer", text: "<full description of what to build, including design requirements, content, colors, and any assets>")

⚠️ CRITICAL: If you skip step 2, nothing happens. The agent exists but has no work. You MUST send the message. Do NOT tell the user "it's working on it" until you have actually called send_message.

After sending, tell the user you've handed it off and will share the result when it comes back. The Frontend Engineer will send you the live URL + screenshots when done — forward those to the user.

When to delegate vs do it yourself:

  • Delegate: building new sites, redesigns, multi-page apps, anything that needs visual testing
  • Do yourself: simple vercel deploy of an existing project, checking deployment status, managing domains/env vars

Best Practices

  • Run pnpm run build locally before deploying to catch build errors early
  • Use --cwd instead of cd to keep your working directory stable
  • For Next.js projects, vercel deploy auto-detects the framework — no extra config needed
  • Use vercel.json only when you need custom build settings, rewrites, or headers

© nanocoai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/add-vercel/container-skills/vercel-cli of nanocoai/nanoclaw.

Open the folder on GitHubat commit 66f0823

Compare with similar skills

Vercel CLI next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Vercel CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vercel CLI this skillnanocoai/nanoclaw31k—~1.4kAutomated safety check: WarnMIT
Env Managerbobmatnyc/claude-mpm155—~2kAutomated safety check: NotesMIT
Env Varsvercel/vercel-plugin301—~3kAutomated safety check: NotesCustom licence
Phase 9 Deploymentww-w-ai/bkit-claude-code600—~2.7kAutomated safety check: NotesApache-2.0
Memstack Deployment Railway Deploycwinvestments/memstack423—~2.1kAutomated safety check: PassProprietary
Vercel Deployinfometa/workbuddyskills342—~1kAutomated safety check: NotesNone

Similar skills

  • Env Manager

    bobmatnyc/claude-mpm

    Environment variable validation, synchronization, and management across local development, CI/CD, and deployment platforms

    155 GitHub stars~2k tokensUpdated 1 mo ago
    DevOps & CloudAuto-check: notes
  • Env Vars

    vercel/vercel-plugin

    Official

    Vercel environment variable expert guidance. An agent skill from vercel/vercel-plugin.

    301 GitHub stars~3k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Phase 9 Deployment

    ww-w-ai/bkit-claude-code

    Deploy to production — CI/CD pipelines, environment config, deployment strategies.

    600 GitHub stars~2.7k tokensUpdated 10 days ago
    DevOps & CloudAuto-check: notes
  • A skill your agent uses when the user says 'deploy to Railway', 'Railway setup', 'railway-deploy', or needs to deploy a Node.js, Python, or Docker application to Railway with environment variables…

    423 GitHub stars~2.1k tokensUpdated 10 days ago
    DevOps & CloudAuto-check passed
  • Vercel Deploy

    infometa/workbuddyskills

    Deploy and manage Vercel projects from the terminal. An agent skill from infometa/workbuddyskills.

    342 GitHub stars~1k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Olore Vercel Latest

    olorehq/olore

    Local vercel documentation reference (latest). An agent skill from olorehq/olore.

    103 GitHub stars~620 tokensUpdated today
    DevOps & CloudAuto-check passed

More from nanocoai/nanoclaw

All 59 skills in this repo
  • Installs or refreshes Iron Proxy and its Iron Control web console for NanoClaw, with a local Docker setup, database, credentials and a human approval bridge.

    31k GitHub stars~4.6k tokensUpdated yesterday
    Auto-check: notes
  • Agent Browser

    nanocoai/nanoclaw

    Drives a web browser from the shell with the agent-browser CLI: open pages, read an element snapshot, click and fill by reference, grab text and screenshots.

    31k GitHub starsUsed in 3 repos~1.6k tokens
    Auto-check passed
  • Installs or refreshes OneCLI as the gateway provider for NanoClaw, copying the adapter files, registering the provider and running the setup script.

    31k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check: notes
  • Guides a conversational migration from an OpenClaw install to NanoClaw v2, carrying over identity, channel credentials, scheduled tasks and workspace files.

    31k GitHub stars~6k tokensUpdated yesterday
    Auto-check: notes
  • Wires up an additional phone number onto an already-installed Dial channel, so one NanoClaw install answers SMS and AI voice calls on more than one line.

    31k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • NanoClaw LLM Wiki Setup

    nanocoai/nanoclaw

    Adds a persistent wiki knowledge base to a NanoClaw group following Karpathy's LLM Wiki pattern, with folders, a tailored container skill and a CLAUDE.md section.

    31k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed

Works with

Categories

Questions about Vercel CLI

What does Vercel CLI do?

Deploy apps to Vercel. An agent skill from nanocoai/nanoclaw. Vercel CLI is an agent skill from nanocoai/nanoclaw. Deploy apps to Vercel.

When should I use Vercel CLI?

Vercel CLI fits situations like: asked to deploy; publish a web application; manage Vercel projects; environment variables.

How do I install Vercel CLI in Claude Code?

Run `npx skills add nanocoai/nanoclaw --skill vercel-cli -a claude-code`. Or copy the skill folder (.claude/skills/add-vercel/container-skills/vercel-cli in nanocoai/nanoclaw) into .claude/skills/vercel-cli in your project. Claude Code loads it when a task matches its description.

How do I install Vercel CLI in Codex?

Run `npx skills add nanocoai/nanoclaw --skill vercel-cli -a codex`. Or copy the skill folder (.claude/skills/add-vercel/container-skills/vercel-cli in nanocoai/nanoclaw) into .agents/skills/vercel-cli in your project. Codex loads it when a task matches its description.

Can I use Vercel CLI in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nanocoai/nanoclaw --skill vercel-cli -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vercel-cli, .gemini/skills/vercel-cli, .github/skills/vercel-cli and .opencode/skills/vercel-cli in your project.

What does Vercel CLI need to run?

Going by SKILL.md and its folder, Vercel CLI needs the command-line tools its instructions call (vercel, npm, curl and pnpm).

Does Vercel CLI access the network?

SKILL.md names 1 domain. As links in the text: vercel.com. This is read from the text; nothing was executed.

Is Vercel CLI safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): contains instruction-override wording (e.g. “without asking the user”). Read the flagged lines before installing; the check is not a guarantee either way.

What licence does Vercel CLI use?

Vercel CLI is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Vercel CLI use?

About 1.4k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Vercel CLI?

Skills that share tags, products or a category with Vercel CLI: Env Manager (bobmatnyc/claude-mpm, 155 stars), Env Vars (vercel/vercel-plugin, 301 stars), Phase 9 Deployment (ww-w-ai/bkit-claude-code, 600 stars) and Memstack Deployment Railway Deploy (cwinvestments/memstack, 423 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Vercel CLI?

nanocoai (a GitHub organization) maintains it in nanocoai/nanoclaw, which has 30,883 GitHub stars. The repository holds 59 skills in this directory. The repository was last updated on October 6, 2026.

Source: nanocoai/nanoclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.