ucp

Implements Universal Commerce Protocol support in Next.js ecommerce codebases through guided sub-commands.

Updated Jul 28, 2026
One-click install
npx skills add https://github.com/Aadi-110i/PEP-PROJECT --skill ucp-aadi-110i
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ucp
Source: https://github.com/Aadi-110i/PEP-PROJECT/tree/main/skills/ucp
Command: npx skills add https://github.com/Aadi-110i/PEP-PROJECT --skill ucp-aadi-110i

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires zod, jose, uuid.

What problem does it solve? Adding Universal Commerce Protocol (UCP) support to a Next.js ecommerce application requires reading a large specification, making architectural decisions, and writing many compliant endpoints by hand. This Skill guides the entire process from initial consultation through scaffolding, validation, and testing. ## Core Features & Use Cases - Guided Consultation & Planning: Walks through 12 qualifying questions about roles, capabilities, transports, and payment handlers, then persists decisions in ucp.config.json and generates a phased implementation plan. - Code Scaffolding & Gap Analysis: Generates TypeScript types, Zod schemas, API routes, and discovery profiles, and uses AST-based analysis to find gaps between existing checkout code and UCP requirements. - Validation & Testing: Validates implementations against UCP schemas, generates the /.well-known/ucp discovery profile, and produces unit tests for handlers. - Use Case: A merchant running a Next.js store wants to expose a UCP-compliant checkout over REST and MCP. They run /ucp init, answer the consultation questions, scaffold the full implementation, and validate it against the spec. ## Quick Start Ask the assistant to run /ucp init to clone the UCP specification and create the initial configuration for this project.

Frequently Asked Questions about ucp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add UCP checkout support to a Next.js app?

Run /ucp init to clone the spec and create ucp.config.json, then /ucp consult to answer qualifying questions. Follow with /ucp plan and /ucp scaffold to generate compliant checkout endpoints, types, and schemas.

What transports does the Universal Commerce Protocol support?

UCP supports REST, MCP (Model Context Protocol), A2A (Agent-to-Agent), and embedded iframe checkout transports. You select which to enable during consultation, and the config records a transport priority order.

Can I use Edge runtime for UCP endpoints in Next.js?

No, Edge runtime is not supported for UCP implementations. The skill enforces Node.js as the default runtime, with Bun available as an opt-in alternative, and marks generated routes with runtime = 'nodejs'.

How do I check if my existing checkout code is UCP compliant?

Run /ucp gaps to perform AST-based analysis of your existing API routes and checkout logic. It produces a report classifying findings as critical gaps, partial implementations, or compliant areas against UCP requirements.

What is the /.well-known/ucp discovery profile?

It is a JSON endpoint that advertises your UCP version, services, capabilities, and payment handlers to agents and platforms. The /ucp profile sub-command generates it from your ucp.config.json settings.

Which npm packages does UCP scaffolding require?

Generated code requires zod for schema validation and uuid for session IDs. The jose package is added when AP2 mandate signing or webhook JWS signing is enabled in the configuration.