ucp-schema-authoring

Author custom UCP schemas using JSON Schema 2020-12.

35|16|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/OrcaQubits/agentic-commerce-claude-plugins --skill ucp-schema-authoring
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ucp-schema-authoring
Source: https://github.com/OrcaQubits/agentic-commerce-claude-plugins/tree/main/ucp-agentic-commerce/skills/ucp-schema-authoring
Command: npx skills add https://github.com/OrcaQubits/agentic-commerce-claude-plugins --skill ucp-schema-authoring

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the creation of custom Universal Commerce Protocol (UCP) schemas and extensions, enabling seamless integration of unique business logic and domain-specific data models into the UCP framework.

Core Features & Use Cases

  • Schema Creation: Author capability, service, payment handler, component, and type schemas using JSON Schema 2020-12.
  • Extension Development: Define custom extensions by composing with existing UCP capabilities using allOf.
  • Namespace Governance: Adhere to established namespace rules for custom schemas.
  • Use Case: A retailer wants to add a custom discount capability to the UCP checkout flow. This Skill would be used to define the new discount schema and register it as an extension to the standard checkout capability.

Quick Start

Fetch the live UCP schema authoring documentation and the base type schemas from ucp.dev.

Frequently Asked Questions about ucp-schema-authoring

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

FAQPage Schema
How do I create custom schemas for the Universal Commerce Protocol?

To create custom Universal Commerce Protocol schemas, you author capability, service, payment handler, component, and type schemas using JSON Schema 2020-12 standards. This process enables the integration of unique business logic and domain-specific data models into the UCP framework.

Can I extend existing UCP capabilities with custom business logic?

Yes, you can extend existing UCP capabilities by defining custom extensions using `allOf` composition. This allows you to append domain-specific data models, such as custom discount capabilities, directly into standard UCP checkout flows.

What is namespace governance in UCP schema development?

Namespace governance in UCP schema development enforces established naming rules for custom schema creation. It ensures that newly authored capabilities and extensions do not conflict with existing Universal Commerce Protocol structures.

Does UCP schema authoring work with JSON Schema 2020-12?

Yes, UCP schema authoring works exclusively with JSON Schema 2020-12 standards. This ensures that all custom capability, service, payment handler, component, and type schemas adhere to modern validation and composition specifications.

How do I add a custom payment handler schema to a UCP checkout flow?

To add a custom payment handler schema to a UCP checkout flow, you author the schema using JSON Schema 2020-12 and register it as an extension. You compose it with existing UCP capabilities using `allOf` to integrate the custom logic.