Skip to content
Skills Library
DevOps & cloud · Automation

vercel-cli

/vercel-cli

Guides deployment, configuration, and troubleshooting with the Vercel CLI. Use when operating Vercel projects or resources through the CLI, especially for workflows spanning multiple commands, including deployments, CI, build failures, logs, metrics, Speed Insights, traces, environment variables, domains and DNS, firewall and WAF rules, Global Config (Edge Config), feature flags, storage and Blob, Container Registry (VCR), microfrontends, Sandbox, and `vercel api` fallback.

Repository
vercel ↗
Licence
Apache-2.0
Last repository change
12.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
25
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 12.11.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Guides deployment, configuration, and troubleshooting with the Vercel CLI. Use when operating Vercel projects or resources through the CLI, especially for workflows spanning multiple commands, including deployments, CI, build failures, logs, metrics, Speed Insights, traces, environment variables, domains and DNS, firewall and WAF rules, Global Config (Edge Config), feature flags, storage and Blob, Container Registry (VCR), microfrontends, Sandbox, and `vercel api` fallback.

Original author description

Guides deployment, configuration, and troubleshooting with the Vercel CLI. Use when operating Vercel projects or resources through the CLI, especially for workflows spanning multiple commands, including deployments, CI, build failures, logs, metrics, Speed Insights, traces, environment variables, domains and DNS, firewall and WAF rules, Global Config (Edge Config), feature flags, storage and Blob, Container Registry (VCR), microfrontends, Sandbox, and `vercel api` fallback.

How it works

  1. Setup
  2. Execution Context
  3. Project Targeting
  4. Workflow References
Original SKILL.md headings · 49 lines, 647 words
SKILL.md preview
---
name: vercel-cli
description: Guides deployment, configuration, and troubleshooting with the Vercel CLI. Use when operating Vercel projects or resources through the CLI, especially for workflows spanning multiple commands, including deployments, CI, build failures, logs, metrics, Speed Insights, traces, environment variables, domains and DNS, firewall and WAF rules, Global Config (Edge Config), feature flags, storage and Blob, Container Registry (VCR), microfrontends, Sandbox, and `vercel api` fallback.
---

# Vercel CLI Skill

Use the installed CLI's help for command discovery, arguments, flags, defaults, and examples: start with `vercel --help`, then narrow to the command or subcommand. Reuse help already read for that version. These references cover decisions, dependencies, and recovery across operations.

If an older installation lacks a command or needed guidance, retain the workflow caveats and consult the matching documentation. Preserve the project's chosen CLI version; do not upgrade it merely to make a remembered command work.

## Setup

Reuse the project's installed CLI and authenticated context. If the CLI is missing, follow the project's package-manager and version conventions; for a standalone installation, use `npm install --global vercel`. If authentication is missing, run `vercel login` and wait for the user to complete the login or SAML flow. In automation, use an existing `VERCEL_TOKEN` through the environment rather than command-line arguments.

## Execution Context

- Parse stdout for URLs, structured results, and help. Recognized help exits 0; warnings and progress use stderr. JSON and streaming support vary by command.
- Non-interactive mode suppresses prompts but does not imply consent. Detected agents without a TTY can receive it automatically; plain CI may need it explicitly. Confirmation flags are command-specific. Preserve interactive-only handoffs.
- Structured errors can contain `status`, `reason`, `hint`, and suggested `next` commands. Follow a suggestion only when its target and action fit the task; it does not independently authorize linking, authentication, purchases, or mutations.
- Prefer first-class CLI operations when they expose the required data or mutation. For gaps, use [API fallback](references/advanced.md) to discover the endpoint and preserve request/response types.

## Project Targeting

`vercel ci` is repository/team-scoped and does not require a project link; follow [Vercel CI](references/ci.md) for its target resolution instead of the project-link checks below.

When relying on a local link, inspect the resolved owner/project from the directory where subsequent commands will run, for example with `vercel project inspect --non-interactive`. Stop on `link_required` or a mismatch. A supported explicit project/team selector can target one operation without changing local links.

- `<cwd>/.vercel/project.json` takes precedence over repository mappings; a root single-project link is not generally inherited by arbitrary subdirectories.
- `<repo-root>/.vercel/repo.json` selects the deepest mapped directory containing the working directory. Use repository mappings for multiple apps when that matches the repository's setup; a single-app working-directory link remains valid.
- An unmatched repository path may select the sole mapped project non-interactively. Multiple candidates may remain unresolved, and commands that perform setup can enter a linking flow.

An app directory or successful authentication check is not proof of the project target. Use the resolved identity before consequential operations, without imposing relinking or unrelated account discovery on a task that already has an explicit target.

## Workflow References

Read only the references needed for the user's task. A syntax-only question can be answered from help without loading a workflow reference.

| Task                                                             | References                                                                                                                                          |
| ---------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Ship or validate a deployment; transfer CI artifacts             | [Deployment](references/deployment.md), [project infrastructure](references/project-infra.md) for rolling releases and related effects              |
| Inspect, diagnose, search, or rerun Vercel CI runs               | [Vercel CI](references/ci.md)                                                                                                                       |
| Diagnose a failed build, regression, or live request             | [Monitoring and debugging](references/monitoring-and-debugging.md), [API fallback and traces](references/advanced.md)                               |
| Prepare local development or application credentials             | [Environment variables](references/environment-variables.md), [project/team discovery](references/projects-and-teams.md) when the target is unclear |
| Assign domains; configure or troubleshoot DNS in any environment | [Domains and DNS](references/domains-and-dns.md)                                                                                                    |
| Change production routing or protections                         | [Routing](references/routing.md), [Firewall](references/firewall.md)                                                                                |
| Provision or connect application resources                       | [Integrations](references/integrations.md), [storage](references/storage.md), [connectors](references/connectors.md)                                |
| Ship container images or coordinate multiple apps                | [Container registry](references/container-registry.md), [monorepos](references/monorepos.md), [microfrontends](references/microfrontends.md)        |
| Change feature behavior or review application feedback           | [Feature flags](references/flags.md), [Toolbar comments](references/comments.md)                                                                    |
| Configure framework/runtime behavior                             | [Node backends](references/node-backends.md), [Bun](references/bun.md)                                                                              |
| Set up development tooling or external compute                   | [Agent/MCP/Gateway setup](references/agent-and-ai.md), [Sandbox](references/sandbox.md)                                                             |
| Inspect alerts, usage, billing, or CLI maintenance               | [Platform operations](references/platform-ops.md)                                                                                                   |
Files in this package (25)
  • SKILL.md 7 KB
  • command/vercel.md 1 KB
  • references/advanced.md 2 KB
  • references/agent-and-ai.md 1 KB
  • references/bun.md 1 KB
  • references/ci.md 6 KB
  • references/comments.md 1 KB
  • references/connectors.md 1 KB
  • references/container-registry.md 1 KB
  • references/deployment.md 3 KB
  • references/domains-and-dns.md 2 KB
  • references/environment-variables.md 2 KB
  • references/firewall.md 5 KB
  • references/flags.md 1 KB
  • references/integrations.md 2 KB
  • references/microfrontends.md 1 KB
  • references/monitoring-and-debugging.md 5 KB
  • references/monorepos.md 1 KB
  • references/node-backends.md 3 KB
  • references/platform-ops.md 2 KB
  • references/project-infra.md 1 KB
  • references/projects-and-teams.md 1 KB
  • references/routing.md 1 KB
  • references/sandbox.md 1 KB
  • references/storage.md 3 KB

Versions

RepositoryScoreLicence
This page · vercel/vercel100Apache-2.0
vercel-labs/vercel-plugin100Apache-2.0
vercel/vercel-plugin100Apache-2.0
nanocoai/nanoclaw100MIT
mcarmona1064-cell/clawbridge-ai100MIT
mcarmona1064-cell/clawbridge-ai100MIT
420company/artemis95MIT

Database snapshot: 13.11.2026 · package version cc7b801d7b30 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100vercel-developer
    Full-stack Vercel developer skill for deploying and managing Next.js applications. Covers Deployment (preview, production, Git integration, CLI), Environment Variables (per-environment config, NEXT_PUBLIC_ prefix, secrets), Domains (custom domains, DNS, SSL), Vercel CLI (deploy,…
  • 100local-vercel-api-21362b29
    Vercel app and REST API expert guidance. Use when the agent needs live access to Vercel projects, deployments, environment variables, domains, logs, or documentation through the connected Vercel app or REST API.
  • 90working-with-vercel
    Use when working with the Vercel **hosting platform** — the `vercel`/`vc` CLI (deploy, dev, build, env, dns, domains, blob, edge-config, firewall, rolling-release, logs, link, pull, tokens, redeploy, rollback, promote, mcp, …), the official hosted **MCP server**…
  • 100managing-vercel
    Vercel platform CLI for frontend deployments, serverless functions, and edge network management. Use for deploying applications, managing domains, environment variables, and debugging deployments.
  • 100vercel
    Inspect Vercel projects, deployments, build logs and domains via the Vercel REST API. Use when the user mentions Vercel, a deployment that failed / is building, build or runtime logs, a preview URL, project domains, or wants to check / redeploy a Vercel project.
  • 90vercel-storage-data
    Vercel data and storage services including Postgres, Redis, Vercel Blob, Edge Config, and data cache. Use when selecting data storage or caching on Vercel.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.