variant-option-normalizer
Installation
SKILL.md
Purpose
Scans product variants for inconsistent option values (e.g., "Sm", "Small", "small", "S" all meaning the same size) and bulk-updates them to a canonical set you define. Inconsistent option naming breaks size filters, causes customer confusion, and prevents search apps from grouping variants correctly.
Prerequisites
- Authenticated Shopify CLI session:
shopify store auth --store <domain> --scopes read_products,write_products - API scopes:
read_products,write_products
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| store | string | yes | — | Store domain (e.g., mystore.myshopify.com) |
| option_name | string | yes | — | Option to normalize (e.g., Size, Color) |
| mapping | object | yes | — | Map of non-standard → canonical values (e.g., {"Sm": "S", "small": "S", "Sml": "S"}) |
| filter | string | no | — | Optional product filter (e.g., tag:apparel) |
| dry_run | bool | no | true | Preview changes without executing mutations |
| format | string | no | human | Output format: human or json |