Install the skill

The reference skill is the primary way to integrate — a lightweight markdown + curl client your agent runs. (An MCP server is deferred until there's cross-client demand.)

1. Copy the skill

From the repo, copy the skill into your agent's skills directory:

# Claude Code
cp -r clients/skill/.claude/skills/commonspecs ~/.claude/skills/

For project-scoped use, copy into the repo's .claude/skills/ instead.

2. Set your token

export COMMONSPECS_API_TOKEN="cs_live_…"
export COMMONSPECS_DEFAULT_COUNTRY="PL"   # optional, ISO 3166-1 alpha-2

Or write ~/.commonspecs/config.json:

{ "api_token": "cs_live_…", "default_country": "PL" }

3. Ask

Ask your agent a product question and it picks the right call:

• "what's the fabric weight on the Nudie Gritty Jackson?" → lookup_product
• "what raw denim should I buy?" → search_products / category rankings
• "compare these two jeans on real specs" → compare_products
• show it a photo of a label → it reads the values + EAN and looks them up; the photo never leaves your machine

What it does with the answer

The skill reports every fact with its confidence, hedges low-confidence leads, shows both sides of a disputed value, and surfaces the quality_score with what's missing. It never invents a value it didn't get back. When a field would benefit from another source and you're interested, it can fetch one and contribute it back — the conversation is the contribution path.

See the API reference for the raw endpoints, or the methodology for how the score is built.