# ucp

Walks a Next.js project through UCP adoption: qualifying questions, config, scaffolding, discovery profile, tests and schema validation.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 905 installs · ★ 15
- Author: vercel-labs
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/vercel-labs/agentic-commerce-skills/tree/HEAD/ucp/SKILL.md
- Updated: 2026-02-04
- HTML: https://affpapa.org/en/nevibecode/skills/vercel-labs-ucp

## What it does

The `ucp` skill gives your agent a set of sub-commands for implementing the Universal Commerce Protocol. Run it bare and you get the list: `init`, `consult`, `plan`, `gaps`, `scaffold`, `validate`, `profile`, `test`, `docs`. The usual path runs from init through consult, plan, scaffold, profile, test and validate.

The spec itself is not bundled. On `init` the skill looks for a local copy in `./ucp/`, otherwise pulls `./.ucp-spec/` with `git pull`, and if neither exists it clones the UCP repository and appends the path to `.gitignore`. Every decision lands in `ucp.config.json` at the project root: roles, runtime, enabled transports (`rest`, `mcp`, `a2a`, `embedded`), payment handlers, flags such as AP2 mandates and identity linking, and the domain for `/.well-known/ucp`.

Edge runtime is out — Node.js only, with Bun as an opt-in experimental option. If `ucp.config.json` already exists, the skill asks whether to overwrite, merge or abort. Gap detection leans on AST parsing and data flow tracing, so on a codebase with unusual routing it is worth running `gaps` first and reading what it flags before scaffolding anything.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add vercel-labs/agentic-commerce-skills --skill ucp -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/ucp/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/ucp/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add vercel-labs/agentic-commerce-skills --skill ucp -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/ucp/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add vercel-labs/agentic-commerce-skills --skill ucp -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/ucp/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install vercel-labs/agentic-commerce-skills ucp
```

2. **Manually: put the files in place**
- File: `.github/skills/ucp/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add vercel-labs/agentic-commerce-skills --skill ucp -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/vercel-labs/agentic-commerce-skills --path ucp
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/ucp/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add vercel-labs/agentic-commerce-skills --skill ucp -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/vercel-labs/agentic-commerce-skills/tree/HEAD/ucp/SKILL.md

## When to use it
- break UCP adoption into steps you can actually finish
- spot the parts of an existing codebase that fall short of the spec
- generate a working checkout handler scaffold
- produce the discovery profile for `/.well-known/ucp`
- check an implementation against UCP schemas before release

## Example prompts
- /ucp init
- /ucp consult
- /ucp gaps

## Similar
- [post-purchase-upsell-flow](https://affpapa.org/en/nevibecode/skills/post-purchase-upsell-flow.md) — skill · 103100 installs
- [shopify-polaris-checkout-extensions](https://affpapa.org/en/nevibecode/skills/shopify-polaris-checkout-extensions.md) — skill · ★ 7596
- [storefront-best-practices](https://affpapa.org/en/nevibecode/skills/storefront-best-practices.md) — skill · 4600 installs
- [ecommerce-checkout-optimization](https://affpapa.org/en/nevibecode/skills/ecommerce-checkout-optimization.md) — skill · 1200 installs
- [shopify-checkout-customization](https://affpapa.org/en/nevibecode/skills/shopify-checkout-customization.md) — skill · 1000 installs
- [e-commerce-retail](https://affpapa.org/en/nevibecode/skills/e-commerce-retail.md) — skill · 645 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md