shop-catalog-audit— agent skill

You are an assistant that executes this skill workflow for the user.

You MUST execute the required tool workflow and return the output in the required format sections. Do not skip required steps and do not replace the required report/template with a short summary.

Goal

Identify all product sheets that hurt conversion (no image, empty description, no variant…) and deliver a list sorted by impact.

Access contract

• READ_ONLY is enough.

Default quality rules

A sheet is flagged as problematic if:

• No attached image (slide)
• Empty or < 30-character description
• Price is 0 or missing
• No variant despite the product requiring one (options present)
• No assigned collection
• No assigned tag
• Negative or inconsistent stock (except `-1`, which means unlimited stock)

Required Tool Workflow (strict order)

Follow the sequence below exactly when those tools are available for the request context.

1. shop_list_products: list all products (full pagination).
2. For each returned product, apply quality rules on the fields already

available in the list (avoid a get if not needed).

1. For "suspect" products (incomplete fields in the list),

shop_get_product to confirm before classifying.

1. Group issues by type so the user can fix in batches (e.g. "add an image

to these 12 products").

Tools used

• shop_list_products
• shop_get_product (targeted, not across the whole catalog)
• shop_list_tags, shop_list_collections (reference data)
• shop_list_paragraphs (if paragraph verification requested)

Output contract (exact sections required)

The final answer MUST include all sections shown in this output template, in the same order.

## Catalog quality score: X/10 (N products, M problematic)

### 🔴 Critical (fix first)
- Missing price: N products [IDs...]
- No image: N products [IDs...]

### 🟡 To improve
- Description too short: N products
- No tag: N products

### 🟢 Minor
- No collection: N products

## Top 10 products to fix first
| Product | Issues | Recommended action |
|---------|--------|---------------------|

Do not replace this output with a one-line answer.

Guardrails (hard rules)

• Never suggest an edit without explicit permission — the skill is

read-only by design.

• If the user wants to fix, redirect to shop-product-launch or

individual update tools.

• Quality thresholds are tunable (the user can say "a 10-char description

is fine"); adjust without restarting the audit.

• Large catalogs: if the catalog has 500+ products, warn the user

about the cost. Prefer filtering by collection/tag to audit in chunks rather than fetching everything.

Next possible actions

• Run shop-product-launch to fix a specific product (or recreate a

missing sheet).

• Run shop-best-sellers to check whether the incomplete sheets are

actually selling (prioritize fixes).

• Run shop-stock-check if the audit surfaces many negative-stock

anomalies.