How do I install the Ucp Catalog skill?

Run npx skillmds@latest add viryazheng/ucp-catalog in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ucp Catalog safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ucp Catalog?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ucp Catalog free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ucp Catalog?

ViryaZheng (@viryazheng) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ucp Catalog by viryazheng — Agent Skill

Name: Ucp Catalog
Author: ViryaZheng

Ucp Catalog

Maps merchant product data from Shopify products.json, CSV, or existing JSON into the repo's UCP-style catalog JSON. Use after ucp-audit when product data needs to be normalized before UCP checkout work or OpenAI ACP feed export.

ViryaZheng aca7ed9 4 files · 14.2 KB Updated Sep 17, 2026

File contents

UCP Catalog Mapper

Normalize merchant product data into catalog.json.

Inputs

Shopify public products.json: --source shopify --url https://store.com
CSV export: --source csv --file products.csv
Existing JSON: --source json --file products.json

The script currently does not implement authenticated WooCommerce, BigCommerce, or browser scraping adapters. Treat those as future connectors unless code is added in this repo.

Run

python ${CLAUDE_SKILL_DIR}/scripts/map_catalog.py \
  --source shopify \
  --url https://example.com \
  --currency USD \
  --output store/clients/example/catalog.json

Output Contract

Write:

catalog.json
mapping-report.md when --report is provided

catalog.json contains:

products[]
metadata.source
metadata.total_products
metadata.total_variants
metadata.currency
metadata.validation_errors

Product records should include stable id, title, description, price_range, and at least one variant. Variant prices are integers in ISO 4217 minor units.

Hard Rules

Never fabricate title, price, availability, SKU, or image data.
Convert prices to minor units: USD 29.99 becomes 2999; JPY has no decimal multiplier.
If validation reports errors, keep the output but clearly report the problem before using it downstream.

Downstream

ucp-checkout can use catalog.json as local product data.
acp-feed can export catalog.json to OpenAI ACP feed JSON.

Frequently asked questions