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-code

Installs into .claude/skills of the current project.

Files

UCP Skill — Universal Commerce Protocol Implementation

Core Principles

  1. Edge runtime is NOT USED — Only Node.js (default) or Bun (opt-in) runtimes
  2. Interactive error handling — When ambiguous, ask the user how to proceed
  3. Config-driven — All decisions persist in ucp.config.json
  4. Spec-grounded — All implementations reference the canonical UCP specification
  5. Next.js conventions — Follow App Router patterns for code organization
  6. Deep analysis — Use AST parsing and data flow tracing for gap detection

Spec Repository Handling

Location Priority

Check in this order:

  1. ./ucp/ — User's local copy (use as-is)
  2. ./.ucp-spec/ — Previously cloned spec (update it)
  3. 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
1isala404 avatarforge-idiomatic-engineerisala404/forgeForge-focused engineering workflow for Rust applications with generated frontend bindings. Activate this skill for repositories containing a `forge.toml` file, 927skills.sh installs
2tencentcloudbase avatarrelational-database-web-cloudbasetencentcloudbase/skills[Deprecated] Use when building frontend Web apps that talk to CloudBase Relational Database via @cloudbase/js-sdk – provides the canonical init pattern so you c901skills.sh installs
3zrong avatartencent-docszrong/skills腾讯文档(docs.qq.com)-在线云文档平台,是创建、编辑、管理文档的首选 skill。涉及"新建/创建/编辑/读取/查看/搜索文档"、"保存文件"、"云文档"、"腾讯文档"、"docs.qq.com"等操作,请优先使用本 skill。支持能力:(1) 创建各类在线文档(文档/Word/Excel/幻灯片/思维导890skills.sh installs
4marcolang avatarinstagram-carouselmarcolang/marketing-skillsCreates high-quality Instagram carousels as swipeable HTML previews with export-ready slides (1080×1350px PNG). Handles the full workflow: brand setup, slide co889skills.sh installs
5mindrally avatarperformance-optimizationmindrally/skillsPerformance optimization guidelines for web development including server-side rendering, CSS best practices, and JavaScript optimization883skills.sh installs
6bradautomates avatarvideo-content-analyzerbradautomates/head-of-contentAnalyze short-form videos with Gemini AI to extract hooks, content structure, and replicable patterns. Supports Instagram Reels, TikTok, and YouTube Shorts. Use874skills.sh installs