
Ucp
A comprehensive implementation assistant for adding Universal Commerce Protocol support to Next.js ecommerce projects. It walks you through the full lifecycle: cloning the spec repo, running a 12-question consultation to configure your UCP implementation, analyzing existing APIs for gaps, scaffolding working handlers and routes, generating the discovery profile at /.well-known/ucp, and validating against schemas. Everything is config-driven through ucp.config.json, and it enforces Node.js or Bun runtimes only (no Edge). The gap analysis uses AST parsing to trace data flows, which is notably more thorough than basic grep patterns. If you're building checkout flows that need to interoperate with AI agents or payment platforms via REST, MCP, or A2A transports, this handles the tedious spec compliance work.
- skills.sh installs
- 936
- GitHub stars
- 16
- last updated
- Aug 21, 2026
Install
$ npx -y skills add vercel-labs/agentic-commerce-skills --skill ucp --agent claude-codeInstalls into .claude/skills of the current project.
Files
UCP Skill — Universal Commerce Protocol Implementation
Core Principles
- Edge runtime is NOT USED — Only Node.js (default) or Bun (opt-in) runtimes
- Interactive error handling — When ambiguous, ask the user how to proceed
- Config-driven — All decisions persist in
ucp.config.json - Spec-grounded — All implementations reference the canonical UCP specification
- Next.js conventions — Follow App Router patterns for code organization
- Deep analysis — Use AST parsing and data flow tracing for gap detection
Spec Repository Handling
Location Priority
Check in this order:
./ucp/— User's local copy (use as-is)./.ucp-spec/— Previously cloned spec (update it)- Neither exists — Clone fresh
Clone Procedure
When cloning is needed:
git clone --depth 1 https://github.com/Universal-Commerce-Protocol/ucp.git .ucp-spec
If HTTPS fails, try SSH:
git clone --depth 1 git@github.com:Universal-Commerce-Protocol/ucp.git .ucp-spec
Update Procedure
When ./.ucp-spec/ exists:
cd .ucp-spec && git pull && cd ..
Sponsors
Details
- Repository
- github.com/vercel-labs/agentic-commerce-skills
- Categories
- Frontend Development, Testing & QA, AI & Agent Building, Cloud & Infrastructure
- First seen
- Jun 3, 2026