vercel-optimize — скилл аудита Vercel для Claude Code
Скилл для аудита расходов и скорости на Vercel: сначала метрики, потом правки в коде и настройках проекта.
npx skills add vercel-labs/agent-skills --skill vercel-optimize -a claude-codeЧто делает vercel-optimize
Скилл ведёт аудит от наблюдаемости. scripts/collect-signals.mjs собирает метрики, usage и contract по привязанному проекту в общем 14-дневном окне, scripts/scan-codebase.mjs проходит по коду, scripts/merge-signals.mjs сводит всё в signals.json. Дальше scripts/gate-investigations.mjs решает, какие маршруты и файлы стоят внимания. Исходники открываются только по цепочке импортов от кандидата.
Справочники внутри: references/docs-library.json для ссылок на доки, references/voice.md для текста отчёта. Цитаты, не совпавшие с версией Vercel или фреймворка, отбрасываются.
Заранее нужны Vercel CLI v53+ с vercel metrics, vercel usage и vercel contract, сессия vercel login, каталог после vercel link, Node.js 20+. Для рекомендаций по конкретным маршрутам нужен Observability Plus. Токены в шелл не вписывают: ни VERCEL_TOKEN=..., ни --token.
Лучше всего работает на Next.js: для App Router и Pages Router есть разметка маршрутов и наборы правок. SvelteKit и Nuxt тоже поддержаны, Astro частично, а Hono, Remix и незнакомые фреймворки по умолчанию блокируются: скилл спросит, нужен ли урезанный аудит. Без Observability Plus файловых рекомендаций по маршрутам не будет.
Какие задачи решает
- понять, из чего складывается счёт за Vercel, по usage и contract
- найти маршруты, которые дорого стоят по Function Invocations и Fast Data Transfer
- проверить, где кеширование разгружает функции
- разобрать расход Build Minutes по проекту
- посмотреть Core Web Vitals и трафик ботов до правок в коде
Примеры запросов агенту
- Соберите метрики Vercel и покажите, почему вырос счёт за этот проект.
- Какие маршруты самые дорогие и что в них поменять?
- Найдите кандидатов на кеширование по Fast Data Transfer.
Как установить vercel-optimize
1Через Skills CLI (Vercel)
npx skills add vercel-labs/agent-skills --skill vercel-optimize -a claude-code2Вручную: положить файлы
~/.claude/skills/vercel-optimize/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/vercel-optimize/
1Через Skills CLI (Vercel)
npx skills add vercel-labs/agent-skills --skill vercel-optimize -a codex2Вручную: положить файлы
.agents/skills/vercel-optimize/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vercel-labs/agent-skills --skill vercel-optimize -a cursor2Вручную: положить файлы
.cursor/skills/vercel-optimize/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vercel-labs/agent-skills vercel-optimize2Вручную: положить файлы
.github/skills/vercel-optimize/SKILL.md1Через Skills CLI (Vercel)
npx skills add vercel-labs/agent-skills --skill vercel-optimize -a gemini-cli2Командой платформы
gemini skills install https://github.com/vercel-labs/agent-skills --path skills/vercel-optimizeВручную: положить файлы
.devin/skills/vercel-optimize/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vercel-labs/agent-skills --skill vercel-optimize -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора6
Весь набор →Похожие
Вопросы о vercel-optimize
Как установить vercel-optimize в Claude Code?
Командой npx skills add vercel-labs/agent-skills --skill vercel-optimize -a claude-code. Файл скилла ляжет в ~/.claude/skills/vercel-optimize/SKILL.md.
Что делает vercel-optimize?
Собирает метрики Vercel и сканирует код, отбирает кандидатов через детерминированные гейты и выдаёт ранжированные рекомендации с привязкой к проверенным файлам и докам нужной версии.
Какие фреймворки поддерживаются?
Next.js App Router и Pages Router, SvelteKit, Nuxt; Astro частично. На Hono, Remix и незнакомых фреймворках скилл остановится и спросит разрешения на урезанный аудит.
