Ucp catalog

Skill ViryaZheng/ucp-onboard/skills/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.From its SKILL.md

Install

npx -y skills add ViryaZheng/ucp-onboard --skill ucp-catalog

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
runs commandsInstructs the agent to run 1 command, including `python ${CLAUDE_SKILL_DIR}/scripts/map_catalog.py --source shopify --url https://example.com --currency USD --output store/clients/example/catalog.json`.

SKILL.md

1.8 KB, 357 tokens by cl100k_base, as published. Nobody here has run it

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.

What ships with it: 3 files

12.5 KB alongside SKILL.md, 1 of them executable

references/

currency-minor-units.md350 B
source-mapping.md506 B

scripts/

map_catalog.pyruns11.6 KB