shopify-admin-cogs-completeness-audit
Installation
SKILL.md
Purpose
Scans every variant in the catalog and surfaces those whose inventoryItem.unitCost is missing or zero. Cost of goods sold (COGS) is the foundation for margin reporting, profit-based pricing decisions, and inventory valuation — a single missing cost silently corrupts every downstream calculation. Read-only — no mutations.
Prerequisites
- Authenticated Shopify CLI session:
shopify store auth --store <domain> --scopes read_products,read_inventory - API scopes:
read_products,read_inventory
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| store | string | yes | — | Store domain (e.g., mystore.myshopify.com) |
| status_filter | string | no | ACTIVE | Variant product status to audit: ACTIVE, DRAFT, ARCHIVED, or ALL |
| vendor_filter | string | no | — | Optional vendor to scope the audit |
| include_zero_cost | bool | no | true | Treat unitCost = 0 as missing (recommended; zero cost is rarely intentional) |
| only_stocked | bool | no | true | Limit to variants with inventoryQuantity > 0 |
| format | string | no | human | Output format: human or json |