ucp

Generates Universal Commerce Protocol scaffolds for Next.js apps with config-driven workflows and gap reports.

63|12|Updated Mar 9, 2026

Search Tags:#next.js #gap analysis #api scaffolding #spec compliance #checkout #ucp #discovery endpoint

Ready to run

npx skills add https://github.com/iBz-04/gloamy --skill ucp-ibz-04

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: ucp
Source: https://github.com/iBz-04/gloamy/tree/main/.agents/skills/ucp
Command: npx skills add https://github.com/iBz-04/gloamy --skill ucp-ibz-04

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams implement the Universal Commerce Protocol (UCP) in Next.js ecommerce projects by turning UCP spec requirements into a concrete, config-driven implementation plan and scaffold.

Core Features & Use Cases

End-to-end UCP workflow: supports init, consult, plan, scaffold, validation, and test/doc generation from a single config file.
Spec-grounded implementation: clones/updates the canonical UCP spec repo and references the correct spec files for required endpoints, schemas, and behaviors.
Next.js App Router conventions: generates discovery and service endpoints using App Router patterns, including capability negotiation and runtime constraints.
Gap detection with deep analysis: performs AST-based scanning and data flow tracing to identify missing compliance items and partial implementations.

Quick Start

Ask the AI to run the command to initialize UCP in the current project: /ucp init.

Frequently Asked Questions about ucp

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

FAQPage Schema

How do I implement Universal Commerce Protocol in a Next.js ecommerce project?▼

To implement Universal Commerce Protocol in a Next.js project, you can initialize a config-driven scaffold that generates discovery and checkout endpoints using App Router conventions. This process clones the canonical UCP spec to ensure your API is fully compliant.

How do I check my existing checkout API for UCP spec compliance gaps?▼

You can check checkout API spec compliance gaps by running an AST-based scan and data flow trace against your codebase. This deep analysis identifies missing UCP required endpoints, schemas, and partial implementations, producing a detailed gap report.

Can I scaffold a UCP discovery endpoint and capability negotiation in Next.js App Router?▼

Yes, you can scaffold a UCP discovery endpoint and capability negotiation directly within Next.js App Router. The generated implementation enforces runtime constraints for Node.js or Bun environments and produces the required REST and MCP transport scaffolds.

What is a Universal Commerce Protocol implementation plan and when do I need one?▼

A Universal Commerce Protocol implementation plan turns UCP spec requirements into a concrete file plan and scaffold for your Next.js codebase. You need one when migrating existing checkout APIs or adding UCP capability negotiation to ensure spec-grounded compliance.

Does UCP implementation work with Bun and Node.js runtimes?▼

UCP implementation explicitly works with both Bun and Node.js runtimes. The config-driven scaffold enforces these specific runtime constraints during generation to ensure your ecommerce checkout and discovery endpoints execute correctly in either environment.

Why does my UCP implementation fail validation after migrating checkout APIs?▼

UCP implementation validation fails when migrated checkout APIs miss required UCP schemas or behaviors. Running a deep gap analysis identifies these partial implementations by tracing data flow, ensuring your config-driven file plan produces fully spec-compliant endpoints and tests.