Vercel Specialist

Reviewed 2026-10-15devopsPrompt / Rule# vercel # nextjs # deployment # serverless # environment-variables

Community skill with patterns and a list of known pitfalls for deploying Next.js apps to Vercel: environment variables, edge vs serverless, previews, domains and caching.

Security Reviewed

Markdown-only deployment guide with example code; no scripts, no network, no keys.

Install Vercel Specialist in Google Antigravity

Antigravity loads skills from .agents/skills/ in your project or ~/.gemini/config/skills/ for all projects (official docs). Full guide

EasiestOption 1: paste this to your Antigravity agent

Install the "Vercel Specialist" skill for Google Antigravity.
Follow the steps at https://www.antigravityskills.org/install/vercel-deployment.md (source: https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/vercel-deployment).
Before running anything, show me what you will download and whether it includes scripts, and wait for my OK.
Install it into this project (.agents/skills/) unless I say global. When done, check that Antigravity lists it as an installed skill.

The agent reads the install file, shows you what it will download and waits for your OK.

Option 2: install it yourself

1. Download the repository
```
git clone --depth 1 https://github.com/sickn33/antigravity-awesome-skills.git /tmp/ag-skills && git -C /tmp/ag-skills log -1 --format=%h
```
We reviewed commit a307264. If the second command prints a different hash, the skill may have changed since our review.
2. Copy the skill into this project (workspace skill)
```
mkdir -p .agents/skills && cp -r /tmp/ag-skills/skills/vercel-deployment .agents/skills/
```
Run from your project root. Antigravity reads workspace skills from .agents/skills/<folder>/; this folder holds SKILL.md and references/detailed-guide.md (2 files, no scripts).
3. Or install it for all projects (global skill)
```
mkdir -p ~/.gemini/config/skills && cp -r /tmp/ag-skills/skills/vercel-deployment ~/.gemini/config/skills/
```
Use this instead of the previous step. Copy only the skills you need: the repo README warns that a large watched skills folder can overload Antigravity's context.
4. Check that Antigravity sees it
Antigravity app: start a new conversation and ask "What skills do you have?"; vercel-deployment should be listed. Antigravity CLI: run /skills (/skills reload in a session that was already open).

The repository's own installer (npx agentic-awesome-skills --antigravity --skills <ids> --dry-run, README) can also install selected skills; the copy steps above use the standard Antigravity skill folders and install only this one.

Using Claude Code, Cursor or Codex? See other assistants below.

What is Vercel Specialist?

vercel-deployment is a community-contributed skill in sickn33's antigravity-awesome-skills collection; its frontmatter credits vibeship-spawner-skills (Apache 2.0). SKILL.md is a short wrapper (34 lines) that sends the agent to references/detailed-guide.md: five deployment patterns (environment variables, edge vs serverless functions, build optimisation, preview deployment workflow, custom domains), eight "sharp edges" with symptoms and fixes, eight validation checks and a short collaboration section.

How to use Vercel Specialist?

Install the skill and ask the agent to prepare or debug a Vercel deployment of a Next.js app. It should use the patterns to set up environment variables per environment, choose edge or serverless per route, and check your code against the sharp edges, for example secrets in NEXT_PUBLIC_ variables.

Key features of Vercel Specialist

✓We counted at a307264: the folder has 2 Markdown files and no scripts: SKILL.md (34 lines, 1,301 bytes) and references/detailed-guide.md (660 lines, 16,908 bytes)
✓We counted: the guide lists 8 sharp edges: NEXT_PUBLIC_ exposing secrets, preview deployments using the production database, large serverless functions with slow cold starts, edge runtime missing Node.js APIs, function timeouts leaving work incomplete, variables present at build but missing at runtime, CORS errors from API routes, and stale data after deployment
✓We counted: 8 validation checks, for example "Secret in NEXT_PUBLIC Variable" (severity CRITICAL, fix: remove the prefix and read the value server-side only) and "Hardcoded Vercel URL" (severity WARNING, use VERCEL_URL)
✓SKILL.md names a prerequisite skill, nextjs-app-router; at a307264 there is no folder with that exact name in the repository (the closest is nextjs-app-router-patterns), so treat the prerequisite as informal
✓We searched the guide for Vercel CLI commands and found none; it teaches settings and code patterns, not vercel commands, so you will still need Vercel's own documentation for the CLI
✓The skill's frontmatter says risk: safe, source: vibeship-spawner-skills (Apache 2.0), added 2026-02-27

When to use Vercel Specialist

1Splitting environment variables between development, preview and production
2Deciding which routes should run on the edge and which on serverless functions
3Checking a Next.js project for secrets exposed through NEXT_PUBLIC_ variables before going live

Source and files

Repository: sickn33/antigravity-awesome-skills (MIT)
Upstream risk label: safe
Added upstream: 2026-02-27
SKILL.md size: 1.3 KB
Files in the skill folder: SKILL.md · references
Listing synced: 2026-10-05 from commit bdacd76

Installation & Setup Guide

Agent Rules / Prompt Setup

Follow these steps (taken from the project's own docs) to configure Vercel Specialist in your development environment.

Step 1: Claude Code (manual copy)claude

mkdir -p .claude/skills && cp -r /tmp/ag-skills/skills/vercel-deployment .claude/skills/

Not documented per skill by the repository; this uses Claude Code's standard .claude/skills/ folder after the clone above.

Step 2: Cursor: not documented by the projectcursor

The README lists installer targets for several hosts, but gives no per-skill Cursor path, so we do not list one.

Usage Example & Verification

Prompt / Request Example

1) SKILL.md "When to Use" triggers: vercel, deploy, deployment, hosting, production, environment variables, edge function, serverless function.

2) Our example: "Use the vercel-deployment skill to check this Next.js repo before we deploy: look for secrets in NEXT_PUBLIC_ variables, hardcoded Vercel URLs and Node APIs used in edge routes, and list each finding with the file."
-> The agent searches your code for the patterns in the guide's validation checks and reports file by file; it changes nothing unless you ask.

3) Our example: "Our preview deployments write to the production database. Using the skill, propose a per-environment variable setup."
-> The agent follows the guide's preview-database sharp edge and the VERCEL_ENV pattern to separate values for development, preview and production.

Security Review

Static review

Reviewed Date

2026-10-15

Audited Ref / Commit

a3072641b750a1fb2f6ce695a5f984ea3d4c3ec1

Reviewer

antigravityskills.org (static review)

Markdown-only deployment guide with example code; no scripts, no network, no keys.

Full review: scope, findings, risks

Audit Scope:SKILL.md read in full; references/detailed-guide.md read for all headings, the five patterns, the eight sharp edges (first in full, others by heading and symptoms), the eight validation checks and collaboration section, and searched for commands, URLs and key names; repository README install and disclaimer sections and LICENSE, all at commit a307264 (2026-10-15). Static review only; nothing was executed.

Key Findings:Instruction-only skill. Two Markdown files; code blocks are TypeScript/JavaScript examples using process.env values (VERCEL_ENV, VERCEL_URL) and a config snippet. No executable files, no commands to run, no URLs fetched, no credentials.

Identified Operational Risks & Permissions:Low. The example code mentions environment variables and secrets by name only; it contains no real values.

SKILL.md and the guide were searched for shell commands, package installs, URLs and key names: the only environment-variable use is example code reading VERCEL_ENV and VERCEL_URL, and one comment suggesting installing @next/bundle-analyzer. No credentials appear. This is a read of the text, not a behaviour test.

Operational Notes & Known Limitations

Known Limitations

•Next.js-focused; other frameworks on Vercel are not the subject
•It does not deploy anything: the agent needs your Vercel access (CLI or dashboard) for that, which is outside this skill
•The code snippets are examples written against the Next.js versions current when the skill was written; check them against the Next.js and Vercel docs you use
•The skill's own Limitations section says output is not a substitute for environment-specific validation, testing or expert review

Frequently Asked Questions

Is the Vercel Specialist skill safe?

It is two Markdown files. We read the wrapper and searched and read the guide: no scripts, no vercel CLI commands, no network calls and no API keys. It only contains example code and advice. Deploying is done with your own Vercel access.

How do I install Vercel Specialist in Antigravity?

Clone sickn33/antigravity-awesome-skills, copy skills/vercel-deployment into .agents/skills/ (or ~/.gemini/config/skills/), then ask "What skills do you have?" (Antigravity CLI: /skills). The project README documents its own installer for selected skills.

Does it deploy my site?

No. It guides how you configure and check a deployment; the agent would need your Vercel login or CLI to deploy, which the skill neither asks for nor includes.

Do I need another skill with it?

SKILL.md lists nextjs-app-router as a prerequisite, but no folder with that name exists in the repository at the commit we reviewed. The skill works as a standalone guide.

Is it an official Google skill?

No. It is community-contributed to an independent collection whose README says it is not affiliated with or endorsed by Google.

Supported Platforms

antigravityclaude

View Source on GitHub

Keep exploring this topic

Browse the full Antigravity skills directory for more source-linked skills with install steps and static safety reviews.

More devops skills #vercel #nextjs #deployment #serverless Use cases

Related Skills

🚀

Cloudflare Wrangler

@cloudflare

Cloudflare's official wrangler skill: tells an AI agent how to deploy, configure and debug existing Wrangler-based Workers projects using current Cloudflare docs.

Static reviewacts in your accountsneeds API keyinstructions only

cloudflarewrangler

🚀