Skip to content

BLOG / introducing-sku-md-v0-8.mdx

Introducing SKU.md v0.8 draft

A practical overview of the publisher-owned product context layer, its document family, and its trust boundaries.

Published

Original specification version: v0.8

A publisher-owned context layer

Commerce information is spread across storefront pages, structured data, feeds, sitemaps, policies, and live APIs. SKU.md gives a publisher one Markdown entry point that explains where those sources are and what each one is authoritative for.

It does not replace Product JSON-LD, merchant feeds, MCP, UCP, or checkout APIs. It connects those surfaces so an automated consumer can discover them without guessing.

What the v0.8 draft organizes

The draft separates a root catalog_manifest from optional partition indexes and product documents. The smallest manifest-basic profile can publish identity, language, knowledge, and catalog entry points without pretending to offer live commerce capabilities.

Product documents can add sourced product facts and an offer snapshot. Facts that can change at decision time still need live verification.

Publisher facts, consumer decisions

A publisher can state what it knows, where a fact came from, and when it was verified. A consumer still decides whether that evidence is sufficient for its task. SKU.md does not grant permission, guarantee freshness, rank a merchant, or make checkout safe by itself.

Start with the smallest honest document

Begin with manifest-basic, link the catalog surfaces that already exist, and keep volatile claims out of static prose. Add richer documents only when there is real source material and a clear consumer need.

Further reading

For the current category definition, read What is SKU.md?.