shopify-catalog-audit

Solid

Use when someone wants to find product-data problems across a Shopify catalog: "audit my catalog", "find PDP problems", "which products have missing photos / thin or missing descriptions / pricing anomalies", "$0 or compare-at-inverted prices", "products missing type or vendor", "catalog quality sweep", "product data health check", "which listings are broken", "run a catalog audit before a big sale". Read-only: it locates and ranks problems, it does not change anything. Not for FIXING the problems it finds (use shopify-catalog-cleanup for debris/archiving, shopify-seo-metadata for missing SEO meta, shopify-alt-text for missing image alt text).

Data & Documents 46 stars 2 forks Updated 2 weeks ago MIT

Install

View on GitHub

Quality Score: 84/100

Stars 20%
56
Recency 20%
90
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Shopify Catalog Audit Finding the problems, not fixing them. This is the **FIND** stage of catalog work: it produces a ranked, justified list of product-data defects and hands them off. The **FIX** stage lives in sibling skills: `shopify-catalog-cleanup` (archiving/debris), `shopify-seo-metadata` (missing SEO meta), `shopify-alt-text` (missing image alt). Don't mutate here. The core principle: on a catalog too large to eyeball, **don't read every PDP.** Build a cheap deterministic index over the whole catalog, let the model form justified hypotheses about where problems cluster, deep-read only that slice, then verify against the Admin API. The full method is in [references/triage-method.md](references/triage-method.md); the GraphQL recipes are in [references/queries.md](references/queries.md). ## Store access Read-only audit. Grant the **minimum scope, `read_products`**, and nothing else: this skill never needs a write scope, and a read-only token is the cheapest guarantee it can't damage the catalog. **Lane A: custom-app token (scriptable).** In Shopify admin: Settings → Apps and sales channels → Develop apps → create an app → grant `read_products`, then install and copy the Admin API access token. Export it; never write it to a committed file: ```bash export SHOPIFY_STORE="your-store.myshopify.com" export SHOPIFY_ACCESS_TOKEN="<your Admin API access token>" # env, not disk ``` ```bash curl -s "https://$SHOPIFY_STORE/admin/api/2025-07/graphql.json" \ -H "X-Shopi...

Details

Author
kgelster
Repository
kgelster/awesome-ecom-skills
Created
2 months ago
Last Updated
2 weeks ago
Language
Shell
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

Data & Documents Solid

shopify-catalog-cleanup

Use when fixing the debris an audit found in a Shopify catalog: bulk-archive dead/discontinued/zero-inventory products, clean up catalog debris, kill ghost review stars (empty star ratings a theme still renders after a review app was uninstalled), remove orphaned metafields left by an uninstalled app, strip HTML artifacts from product descriptions (double-nested bold, fully-bold paragraphs, empty tags), or fix messed-up / mangled product descriptions in bulk. Mutating cleanup work: archive vs delete, metafieldsDelete, description rewrites. Not for FINDING what's wrong (use shopify-catalog-audit) or filling missing metadata like SEO titles and alt text (use shopify-seo-metadata).

46 Updated 2 weeks ago
kgelster
AI & Automation Listed

the-catalog-auditor

Audits a whole product catalog export for missing attributes, thin or empty descriptions, duplicate copy, and image gaps, ranked by revenue rather than row count. Use when the catalog has too many SKUs to review page by page, before a marketplace or feed push, or when only the best sellers seem to have real content. Boundary: `the-citation-auditor` audits blog and content pages for citability to AI search engines. This skill audits product catalog completeness at SKU scale, not content citability.

1 Updated today
sidchaudhary
AI & Automation Listed

shop-catalog-audit

Shop catalog quality audit: detect incomplete products (no image, no description, no variant, no tag, no collection, missing price), produce a prioritized cleanup todo list. Read-only — suggests fixes but does not apply them. Use by default whenever the user wants to audit product quality, find incomplete listings, or clean up the catalog, even indirectly or with approximate wording. Prefer this skill over raw MCP tools when it reasonably fits. Skip only if the user explicitly asks not to use this skill/workflow.

2 Updated yesterday
goodbarber