ucp — скилл для Claude Code: поддержка Universal Commerce Protocol
Ведёт проект на Next.js через все шаги внедрения Universal Commerce Protocol: от вопросов о роли и рантайме до проверки схем и профиля discovery.
npx skills add vercel-labs/agentic-commerce-skills --skill ucp -a claude-codeЧто делает ucp
Скилл ucp добавляет в агент набор подкоманд для работы со спецификацией Universal Commerce Protocol. Вызов без аргумента показывает список: init, consult, plan, gaps, scaffold, validate, profile, test, docs. Типовой порядок — от инициализации к консультации, плану, генерации кода, профилю, тестам и валидации.
Спецификация не хранится внутри скилла. При init он ищет локальную копию в ./ucp/, иначе обновляет ./.ucp-spec/ через git pull, а если её нет — клонирует репозиторий UCP и дописывает путь в .gitignore. Все решения по проекту скилл складывает в ucp.config.json в корне: роли, рантайм, набор транспортов (rest, mcp, a2a, embedded), обработчики платежей, флаги вроде AP2-мандатов и привязки личности, домен для /.well-known/ucp.
Рантайм Edge не поддерживается — только Node.js, а Bun идёт как опциональный экспериментальный вариант. Если в проекте уже есть ucp.config.json, скилл спросит, перезаписать его, слить с новыми ответами или прервать работу. Анализ пробелов в существующем коде опирается на разбор AST и трассировку потоков данных, так что для проекта с нестандартной структурой маршрутов это повод сначала прогнать gaps и посмотреть, что он найдёт.
Какие задачи решает
- разложить внедрение UCP на этапы и не потерять ни один
- найти в существующем коде места, которых не хватает для соответствия спецификации
- сгенерировать рабочий каркас обработчиков checkout
- собрать профиль discovery для
/.well-known/ucp - проверить реализацию по схемам UCP до релиза
Примеры запросов агенту
- /ucp init
- /ucp consult
- /ucp gaps
Как установить ucp
1Через Skills CLI (Vercel)
npx skills add vercel-labs/agentic-commerce-skills --skill ucp -a claude-code2Вручную: положить файлы
~/.claude/skills/ucp/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ucp/
1Через Skills CLI (Vercel)
npx skills add vercel-labs/agentic-commerce-skills --skill ucp -a codex2Вручную: положить файлы
.agents/skills/ucp/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add vercel-labs/agentic-commerce-skills --skill ucp -a cursor2Вручную: положить файлы
.cursor/skills/ucp/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install vercel-labs/agentic-commerce-skills ucp2Вручную: положить файлы
.github/skills/ucp/SKILL.md1Через Skills CLI (Vercel)
npx skills add vercel-labs/agentic-commerce-skills --skill ucp -a gemini-cli2Командой платформы
gemini skills install https://github.com/vercel-labs/agentic-commerce-skills --path ucpВручную: положить файлы
.devin/skills/ucp/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add vercel-labs/agentic-commerce-skills --skill ucp -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Похожие
Рядом в теме «Настройка агента: память, контекст, субагенты»
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Вопросы о ucp
Как установить ucp в Claude?
Выполните npx skills add vercel-labs/agentic-commerce-skills --skill ucp -a claude-code. Скилл окажется в ~/.claude/skills/ucp/SKILL.md.
Что делает скилл ucp?
Проводит через внедрение Universal Commerce Protocol в проект на Next.js: консультация, план, генерация каркаса, профиль discovery, тесты и валидация по схемам. Состояние решений хранится в ucp.config.json.
Можно ли использовать ucp на Edge-рантайме?
Нет, Edge не поддерживается. Доступны Node.js как основной вариант и Bun как опциональный экспериментальный.
