vercel-docs
Look up authoritative, up-to-date Vercel documentation covering deployments, builds, Functions, Fluid Compute, CDN/caching, environment variables, domains, the Vercel CLI, REST API, Security/Firewall, Observability, Storage, AI SDK/Gateway, and the kb troubleshooting guides. Use when the user asks how a Vercel feature works, what a vercel.json field does, how to configure deploys/functions/caching/env vars, when troubleshooting a Vercel build or runtime error, or when you need to cite current official docs rather than rely on training-cutoff knowledge.
- License 许可
- MIT
- 最近更新
- 2026-07-31
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- vercel-docs
- description
- Look up authoritative, up-to-date Vercel documentation covering deployments, builds, Functions, Fluid Compute, CDN/caching, environment variables, domains, the Vercel CLI, REST API, Security/Firewall, Observability, Storage, AI SDK/Gateway, and the kb troubleshooting guides. Use when the user asks how a Vercel feature works, what a vercel.json field does, how to configure deploys/functions/caching/env vars, when troubleshooting a Vercel build or runtime error, or when you need to cite current official docs rather than rely on training-cutoff knowledge.
- allowed-tools
- Bash(python3 *)
- argument-hint
- [topic or doc title]
02 资源文件 9
- 参考文档CHANGELOG.md1.7 KB
- 参考文档README-cn.md2.5 KB
- 参考文档README.md2.4 KB
- 参考文档references/mechanism-cn.md4.1 KB
- 参考文档references/mechanism.md4.0 KB
- 脚本scripts/docs_query.py11.2 KB
- 脚本scripts/docs-source.json231 B
- 参考文档SKILL-cn.md11.5 KB
- 其他VERSION6 B
03 SKILL.md 正文
Vercel Docs
Answers Vercel questions from the official docs on demand: searches a cached copy of the
202 KB llms.txt index (only matching lines ever reach context), then fetches matching
pages as raw markdown. Always prefer this skill over recalling Vercel docs from memory —
Vercel ships changes weekly and model knowledge about it goes stale fast (Edge Functions,
Vercel Postgres/KV, and default runtimes have all changed).
If the user passed an argument ($ARGUMENTS), treat it as the topic. Otherwise infer it
from the conversation.
When to use this skill
- Deployments, builds, Functions, Fluid Compute, Cron Jobs, Middleware
- CDN/caching, ISR, Image Optimization, domains,
vercel.jsonconfiguration - CLI commands, REST API, Security/Firewall, Observability, Storage
- AI SDK/Gateway/MCP, and
kbtroubleshooting guides for build/runtime errors
Out of scope: Next.js framework APIs proper (routing, data fetching, etc.) — prefer nextjs.org for those; this index covers Next.js only as it runs on Vercel.
How this site works
Measured 2026-07-31; full fact sheet in references/mechanism.md.
- Index:
https://vercel.com/llms.txt— 202,696 B, 1406 entries, 20 sections, 13% with prose descriptions (1% terse, 86% bare title-only). - Coverage: the index is the site's own page list (leaf-level), not a curated hub — no second hop needed to find an area.
- Content: every
/docs/*and/kb/*page has a.mdtwin — 4,991 B vs 916,350 B of HTML on a sampled page (99% cheaper). Nevercurlthe HTML page directly. - Gotchas:
https://vercel.com/docs/llms.txt308-redirects to the URL above (the script follows redirects transparently, no special handling needed). Never fetchhttps://vercel.com/docs/llms-full.txt— 7.66 MB, a full-text dump, not an index. Guides (531 entries, 62 KB) has zero prose descriptions — grep it, never read it whole.
Procedure
1. Find candidate pages
python3 ${CLAUDE_SKILL_DIR}/scripts/docs_query.py search '<term>|<synonym>|<the word the docs would use>'
The index is fetched once and cached for 24 h, so repeat queries cost no requests. Only matching lines enter context — never load the whole index.
Routing commands, cheapest first:
| Command | Cost | Use when |
|---|---|---|
search '<regex>' |
~200 tok | always start here |
sections |
~250 tok | search missed and you need the map |
section '<name>' |
200–15,600 tok | full recall inside one area (skip for Guides) |
2. If the search comes back empty
Do not conclude the topic is undocumented. Escalate:
- Widen with synonyms — the docs' word is often not the user's. A page about function request timeouts is titled "Duration", under Compute.
- If the query was not in English, retry with English terms. This index is English-only and a non-English query scores zero matches for reasons that have nothing to do with coverage.
sections, thensection '<most plausible>'for full recall inside it — except Guides, which is too large and undescribed to read whole; keep narrowing thesearchpattern instead (Guides titles read like questions — search the noun, e.g.rate limit, not the phrasing).- Only then say it is not in the docs, and state what you searched.
Use the section routing table below to translate a topic (including a Chinese one) into a section name.
3. Read the pages
python3 ${CLAUDE_SKILL_DIR}/scripts/docs_query.py get <url-from-search>
Returns raw markdown (~3–13 KB/page, measured). Always pass the full URL from a search
or section hit — Vercel renames slugs, so a remembered or guessed URL is not reliable.
Fetch 1–3 pages per batch, then judge whether that answers the question. Loop if not, to a cap of 9 pages. At 9 and still short, stop and tell the user what you read and what is missing — do not silently continue or fill the gap with guesses.
Section routing table
20 sections. Sizes are entry counts as of the last measurement.
| Section (entries) | What it covers / 中文触发词 |
|---|---|
| Compute (77) | Fluid Compute, Functions, runtimes, streaming, WebSockets, Routing Middleware, Cron Jobs, OG image generation, Sandbox, Queues, Workflows, Container Registry — 函数, 定时任务, 冷启动, 中间件, 队列 |
| Build & Deploy (68) | Builds, Deployments, Environment Variables, Git integrations, Deploy Hooks, Deployment Checks, Instant Rollback, Rolling Releases, Monorepos, Microfrontends, Skew Protection, Webhooks, Vercel Drop — 部署, 构建, 环境变量, 回滚, 单体仓库 |
| CDN (40) | Caching, ISR, Partial Prerendering, Image Optimization, routing, system headers, Global Network & regions, custom error pages — 缓存, 图片优化, 边缘网络, 区域 |
| CLI (70) | Every vercel <command> (deploy, env, dev, link, pull, logs, promote, rollback, crons, blob, sandbox, …), global options, release notes. 100% prose descriptions — search alone works very well here — 命令行 |
| Platform (49) | vercel.json Project Configuration, Projects, Domains, Limits, Glossary, Notifications, Build Output API, Checks — 项目配置, 域名, 限额 |
| Security (56) | Firewall/WAF, Bot Management, BotID, OIDC, RBAC, Audit Logs, networking, 2FA enforcement — 防火墙, 限流, 权限, 安全 |
| Observability (52) | Logs, Tracing, Alerts, Query, Notebooks, Speed Insights, Web Analytics, Drains — 日志, 监控, 链路追踪, 性能 |
| AI (168) | Vercel Agent, AI SDK, AI Gateway, MCP, Agent Resources, eve |
| Storage (26) | Blob, Marketplace storage (Postgres/Redis/etc.), Global Config — 存储, 数据库, 对象存储 |
| Access (34) | Account management, Sign in with Vercel, SAML SSO, Directory Sync, Organizations, Deployment Protection, 2FA, Activity Log — 账号, 登录, 单点登录, 部署保护 |
| Integrations (34) | Marketplace, installing/creating integrations, CMS, commerce & payments — 集成 |
| Flags (27) | Vercel Flags, Flags Explorer, Flags SDK — 功能开关, 特性标记, A/B |
| Pricing (35) | Plans, pricing, spend management — 价格, 计费, 用量 |
| Vercel for Platforms (28) | Multi-tenant and multi-project platforms, custom domains per tenant — 多租户 |
| Collaboration (16) | Comments, Draft Mode, Edit Mode, Toolbar — 协作, 评论 |
| Connect (11) | Secure Compute / private network connectivity — 私有网络 |
| Topics (38) | Assorted cross-cutting topic pages |
| SDK Examples (10) | Vercel SDK code snippets |
| (root) (36) | Top-level/getting-started pages: Getting Started, Fundamentals, Frameworks, Production Checklist, Incremental Migration |
| Guides (531) | vercel.com/kb/guide/* how-tos and troubleshooting. Zero prose descriptions — grep only, never section this whole |
Guides is also the right place to look for error-message troubleshooting, which the
main /docs sections often don't cover. Search it on the noun rather than the phrasing.
Context budget
| Step | Cost | Notes |
|---|---|---|
search |
~200 tok | only matched lines |
section |
200–15,600 tok | one area, full recall (skip for Guides) |
| page | ~750–3,250 tok each | 1–3 per batch |
Typical question: search + 1–2 pages ≈ under 5k tokens total. Loading the index whole
would be ~50,700 tokens, which is why nothing here does that. Read one section at a
time; if you cannot tell which section to read, that is a signal to search again with
better terms, not to load several.
Rules
- Never invent a doc URL. Not in the index → say so. Slugs get renamed.
- Never load the whole index, and never touch
llms-full.txt(7.66 MB). - Cite the URL that served the content.
- A 404 on a page URL means the index is stale — re-run
/docs-skill-builder check .claude/skills/vercel/skills/vercel-docs. - Pass through what the docs say. Don't blend with prior knowledge — several widely-held beliefs about Vercel are now wrong (Edge Functions are de-emphasized in favor of Fluid Compute, streaming/SSE work on the Node.js runtime, Vercel Postgres and Vercel KV are retired in favor of Marketplace integrations). Report current docs, not recollection.
04 同仓库更多 Skills
write-agent-skill
Claude Code Agent Skill Author Guide
skill-subagent-design
How Agent Skills and Subagents differ and how to combine them — the skill-as-caller / subagent-as-doer best practice. Use when deciding whether a task should be a skill or a subagent, or when authoring a skill and subagent that work together (e.g. a /name skill that delegates to an isolated subagent).
py-changelog
Maintain the release-history.rst changelog for a Python project before publishing a new version. Use when the user wants to prepare release notes, update changelog, or is about to publish/tag a new version.
maintain-claude-plugins
My personal, authoritative spec for building, developing, versioning, releasing, and wiring dependencies for my own Claude Code plugins through a split-repo plus central-marketplace setup. Use when creating a new plugin repo, laying out a plugin's .claude/skills/<name>/ folder, writing plugin.json or marketplace.json, tagging a plugin release, wiring plugin-to-plugin dependencies, authenticating private repos, or when I ask how to structure, release, or publish my Claude Code plugin.
create-sub-agent
Claude Code Sub Agent Author Guide