skilld
All skills
vercel-labs avatar

/vercel-cli

@51524a1 official
by Vercel Labsvercel-labs/vercel-plugin295 stars
64

Vercel CLI expert guidance. Use when deploying, managing environment variables, linking projects, viewing logs, querying metrics, managing domains, managing feature flags with vercel flags, or interacting with the Vercel platform from the command line.

  • 57 files
  • 222.1 KB
  • Updated 2 weeks ago
  • GitHub

Ask your Agent

Use this Skill: https://skilld.dev/gh/vercel-labs/vercel-plugin/vercel-cli

This session only. Nothing lands on disk.

referencesflags.md

≈718 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Feature Flags

vercel flags manages Vercel Flags for the linked project.

--help is the source of truth for options and examples. Run vercel flags --help for the current subcommand list and vercel flags <cmd> --help before using a subcommand. The map below routes by task and carries no options on purpose.

Subcommand Map

# Read
vercel flags list                 # flags in the project (alias: ls)
vercel flags inspect <flag>       # kind, variants, what each environment serves
vercel flags versions <flag>      # revision history (subcommands: list, diff)
vercel flags evaluations <flag>   # evaluation metrics

# Change what an environment serves
vercel flags set <flag>           # serve one variant (all kinds)
vercel flags enable <flag>        # boolean shortcut for true
vercel flags disable <flag>       # boolean shortcut for false
vercel flags use-targeting <flag> # enable targeting for an environment

# Targeting
vercel flags split <flag>         # weighted traffic split across variants
vercel flags rollout <flag>       # staged rollout from one variant to another
vercel flags rules <flag>         # targeting rules (subcommands: list, add, update, remove, move)
vercel flags segments             # reusable audience segments (subcommands: list, inspect, create, update, remove)

# Lifecycle
vercel flags create <flag>        # new flag (alias: add)
vercel flags update <flag>        # variant values and labels
vercel flags archive <flag>       # required before rm
vercel flags unarchive <flag>
vercel flags rm <flag>            # delete an archived flag (alias of remove)

# Tooling
vercel flags sdk-keys             # SDK keys (subcommands: list, add, remove)
vercel flags prepare              # flag definition fallbacks for builds outside Vercel
vercel flags override             # encrypt or decrypt a vercel-flag-overrides cookie token
vercel flags open [flag]          # open the dashboard

CLI Contracts

  • Flags commands need a linked project. Confirm the target with vercel project inspect --non-interactive first (see SKILL.md).
  • Use --json where a subcommand offers it and parse only stdout.
  • Commands that ask for confirmation (archive, unarchive, rm, sdk-keys rm, and others that list --yes in --help) need --yes in non-interactive runs.

Flags SDK Skill

Everything flags-specific lives in the flags-sdk skill (npx skills add vercel/flags@flags-sdk): declaring flags with flag() and vercelAdapter, matching a CLI flag key to the key in code, identify() entities and the --by / --condition attribute contract, adopting a flag that already exists (inspect first), lifecycle and production safety, FLAGS / FLAGS_SECRET, prepare, and override. Use that skill for those topics; this reference does not repeat them.

Source: SKILL.md on GitHub

Third-party checks

No third-party reports yet.

Provenance

Signed by skilld at 51524a1. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 7 hours ago.

Activeupdated 2 weeks ago

Capability

Other metadata
metadata
{
  "priority": 4,
  "docs": [
    "https://vercel.com/docs/cli"
  ],
  "sitemap": "https://vercel.com/sitemap.xml",
  "pathPatterns": [
    "vercel.json",
    "vercel.ts",
    ".vercel/**",
    ".vercelignore",
    "now.json"
  ],
  "bashPatterns": [
    "^\\s*vercel(?:\\s|$)",
    "^\\s*vc(?:\\s|$)",
    "\\bnpx\\s+vercel\\b",
    "\\bpnpm\\s+dlx\\s+vercel\\b",
    "\\bbunx\\s+vercel\\b",
    "\\byarn\\s+dlx\\s+vercel\\b",
    "\\bnpx\\s+@vercel/config\\b"
  ],
  "promptSignals": {
    "phrases": [
      "check deployment",
      "check deploy",
      "deployment status",
      "deploy status",
      "vercel logs",
      "vercel metrics",
      "deployment logs",
      "deploy logs",
      "vercel inspect",
      "is it deployed",
      "deploy failing",
      "deploy failed",
      "deployment error",
      "check vercel",
      "vercel status"
    ],
    "allOf": [
      [
        "check",
        "deployment"
      ],
      [
        "check",
        "deploy"
      ],
      [
        "vercel",
        "status"
      ],
      [
        "vercel",
        "logs"
      ],
      [
        "vercel",
        "metrics"
      ],
      [
        "deploy",
        "error"
      ],
      [
        "deploy",
        "failed"
      ],
      [
        "deploy",
        "stuck"
      ]
    ],
    "anyOf": [
      "deployment",
      "deploy",
      "vercel",
      "production"
    ],
    "noneOf": [
      "terraform",
      "aws deploy",
      "heroku"
    ],
    "minScore": 6
  }
}
retrieval
{
  "aliases": [
    "vercel command line",
    "vc cli",
    "deploy command",
    "vercel terminal"
  ],
  "intents": [
    "deploy from cli",
    "link project",
    "manage domains",
    "view logs from terminal"
  ],
  "entities": [
    "vercel CLI",
    "vercel deploy",
    "vercel env",
    "vercel link",
    "vercel logs",
    "vercel metrics"
  ]
}
chainTo
[
  {
    "pattern": "\"functions\"\\s*:\\s*\\{|\"maxDuration\"\\s*:|\"memory\"\\s*:",
    "targetSkill": "vercel-functions",
    "message": "Functions configuration detected in vercel.json — loading Vercel Functions guidance for runtime options, streaming, and Fluid Compute.",
    "skipIfFileContains": "\"crons\"\\s*:"
  },
  {
    "pattern": "\"redirects\"\\s*:\\s*\\[|\"rewrites\"\\s*:\\s*\\[|\"headers\"\\s*:\\s*\\[",
    "targetSkill": "routing-middleware",
    "message": "Routing rules in vercel.json — loading Routing Middleware guidance for platform-level request interception patterns."
  }
]

README badge

README badge for vercel-labs/vercel-plugin/vercel-cli