From shopify-admin-skills
Assign every product a Shopify Standard Product Taxonomy category so AI agents can map a shopper's intent to the right category and surface the store's products.
How this skill is triggered — by the user, by Claude, or both
Slash command
/shopify-admin-skills:shopify-admin-agentic-product-taxonomyThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
AI shopping agents resolve a query ("running shoes", "office chair", "sustainable sneakers") to a taxonomy node, then retrieve products in that node. Products with no Standard Product Taxonomy category are invisible to that mapping — they only surface on exact keyword luck. This skill finds uncategorized (or mis-categorized) products and assigns the correct Shopify standard taxonomy category, i...
AI shopping agents resolve a query ("running shoes", "office chair", "sustainable sneakers") to a taxonomy node, then retrieve products in that node. Products with no Standard Product Taxonomy category are invisible to that mapping — they only surface on exact keyword luck. This skill finds uncategorized (or mis-categorized) products and assigns the correct Shopify standard taxonomy category, inferred from title/type/tags and confirmed against the live taxonomy tree. Fixes category-taxonomy-api and lifts catalog-intent-alignment.
shopify auth login --store <domain>)read_products, write_productsAll skills accept these universal parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| store | string | yes | — | Store domain (e.g., mystore.myshopify.com) |
| format | string | no | human | Output format: human (default) or json |
| dry_run | bool | no | false | Preview mutations without executing |
Skill-specific parameters:
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| collection_id | string | no | — | Limit to a collection GID |
| tag | string | no | — | Limit to a product tag |
| only_missing | bool | no | true | If true, only assign products with no category; if false, also review mismatches |
| confidence_floor | float | no | 0.7 | Skip products whose best taxonomy match scores below this |
⚠️ Step 4 (
productUpdate) sets thecategoryon live products, which affects storefront facets, marketplaces, and tax. A wrong category mis-files a product everywhere. Rundry_run: true, review the proposedproduct → categorymapping, and only auto-assign matches aboveconfidence_floor; queue the rest for human review.
OPERATION: products — query
Inputs: first: 250, optional filter; fields title, productType, tags, category{ id fullName }; paginate.
Expected output: Products with their current category (or null).
OPERATION: taxonomy — query
Inputs: search the standard taxonomy tree by candidate terms derived from each product's type/title.
Expected output: Candidate taxonomy category nodes (id + fullName) to match against.
COMPUTE (no API): score each product against candidate nodes; pick the best ≥ confidence_floor. Emit the proposed mapping.
OPERATION: productUpdate — mutation
Inputs: { id, category: <taxonomyCategoryId> } per confident match.
Expected output: Updated product category; collect userErrors.
# products:query — validated against api_version 2025-01
query TaxonomyProducts($first: Int!, $after: String, $query: String) {
products(first: $first, after: $after, query: $query) {
edges {
node {
id
title
productType
tags
category { id fullName }
}
}
pageInfo { hasNextPage endCursor }
}
}
# taxonomy:query — validated against api_version 2025-01
query TaxonomySearch($search: String) {
taxonomy {
categories(first: 20, search: $search) {
edges { node { id fullName isLeaf level } }
}
}
}
# productUpdate:mutation — validated against api_version 2025-01
mutation TaxonomyAssign($input: ProductInput!) {
productUpdate(input: $input) {
product { id category { id fullName } }
userErrors { field message }
}
}
Claude MUST emit the following output at each stage. This is mandatory.
On start, emit:
╔══════════════════════════════════════════════╗
║ SKILL: <skill name> ║
║ Store: <store domain> ║
║ Started: <YYYY-MM-DD HH:MM UTC> ║
╚══════════════════════════════════════════════╝
After each step, emit:
[N/TOTAL] <QUERY|MUTATION> <OperationName>
→ Params: <brief summary of key inputs>
→ Result: <count or outcome>
If dry_run: true, prefix every mutation step with [DRY RUN] and do not execute it.
On completion, emit:
For format: human (default):
══════════════════════════════════════════════
OUTCOME SUMMARY
<Metric label>: <value>
Errors: 0
Output: <filename or "none">
══════════════════════════════════════════════
For format: json, emit:
{
"skill": "<skill-slug>",
"store": "<domain>",
"started_at": "<ISO8601>",
"completed_at": "<ISO8601>",
"dry_run": false,
"steps": [
{
"step": 1,
"operation": "<OperationName>",
"type": "query",
"params_summary": "<string>",
"result_summary": "<string>",
"skipped": false
}
],
"outcome": {
"metric_key": 0,
"errors": 0,
"output_file": null
}
}
human: count categorized + a CSV (product, old_category, new_category, confidence) and a "needs review" list below the floor. json: { categorized, needs_review, errors, output_file }.
| Error | Cause | Recovery |
|---|---|---|
THROTTLED | API rate limit | Wait 2s, retry up to 3 times |
| No taxonomy match | Niche/ambiguous product | Add to needs-review list, do not guess |
userErrors on update | Invalid category id | Log, skip, continue |
only_missing: true for the first pass; re-categorizing existing assignments is higher-risk and best reviewed.shopify-admin-agentic-readiness-audit to confirm the Matchable pillar improved.npx claudepluginhub 40rty-ai/shopify-admin-skills --plugin shopify-admin-skillsAutomatically categorizes products into store categories using Claude AI analysis of names, descriptions, attributes, SKU patterns, and generates confidence scores for matches.
Manages Shopify product catalogs: products, variants, options, collections, metafields, metaobjects, inventory, bulk operations, taxonomy, media via GraphQL API.
Manages Shopify products, variants, collections, and inventory with GraphQL Admin API. Handles CRUD for catalog integrations, including product options and inventory quantities.