Env Vars
Loads Vercel-specific environment variable guidance: .env file hierarchy, vercel env CLI commands (pull, add, rm, ls), OIDC token lifecycle, and environment scoping. Activates when you touch .env files or run vercel env commands. Chains to ai-gateway when it spots provider API keys, nudging you toward OIDC auth instead. The bootstrap flow section is genuinely useful if you're setting up fresh clones. One heads-up: vercel env pull overwrites your entire .env.local, so any custom variables you added manually get wiped. The skill reminds you to back those up, but it's easy to forget until you lose something. Strong on the operational details that actually bite you.
- skills.sh installs
- 422
- GitHub stars
- 183
- last updated
- Jun 3, 2026
Install
$ npx -y skills add vercel/vercel-plugin --skill env-vars --agent claude-codeInstalls into .claude/skills of the current project.
Files
Vercel Environment Variables
You are an expert in Vercel environment variable management — .env file conventions, the vercel env CLI, OIDC token lifecycle, and environment-specific configuration.
.env File Hierarchy
Vercel and Next.js load environment variables in a specific order. Later files override earlier ones:
| File | Purpose | Git-tracked? |
|---|---|---|
.env | Default values for all environments | Yes |
.env.local | Local overrides and secrets | No (gitignored) |
.env.development | Development-specific defaults | Yes |
.env.development.local | Local dev overrides | No |
.env.production | Production-specific defaults | Yes |
.env.production.local | Local prod overrides | No |
.env.test | Test-specific defaults | Yes |
.env.test.local | Local test overrides | No |
Load Order (Next.js)
.env(lowest priority).env.[environment](development, production, or test).env.local(skipped in test environment).env.[environment].local(highest priority)
Critical Rules
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/vercel/vercel-plugin
- Category
- Cloud & Infrastructure
- First seen
- Jun 3, 2026
More from vercel/vercel-plugin
All 25- Vercel Functions410
- Next Cache Components385
- Next Upgrade368
- Routing Middleware338
- Auth326
- Vercel Storage326
- Vercel Agent317
- Bootstrap315
- Chat Sdk315
- Verification315
- Workflow313
- Runtime Cache312
- Vercel Sandbox308
- Knowledge Update301
- Marketplace300
- Next Forge191
- Nextjs629
- Ai Sdk544
- React Best Practices491
- Deployments Cicd484
- Shadcn458
- Vercel Cli432
- Turbopack429
- Ai Gateway423
Recommended
More Cloud & Infrastructure
json-render-reactvercel-labs/json-renderReact renderer for json-render that turns JSON specs into React components. Use when working with @json-render/react, building React UIs from JSON, creating com391skills.sh installs
googlevercel-labs/emulateEmulated Google OAuth 2.0, OpenID Connect, Gmail, Calendar, and Drive for local development and testing. Use when the user needs to test Google sign-in locally,369skills.sh installs