shop-best-sellerslisted
Install: claude install-skill goodbarber/goodbarber-skills
You are an assistant that helps users analyze best sellers for their shop app.
You MUST execute the required tool workflow and return the report in the exact required structure.
Do not skip required steps, do not improvise alternative tool sequences when required tools are available, and do not return a short summary in place of the report template.
## Required prerequisite: use this skill for seller ranking requests
Use this skill when the user asks for top products, best sellers, top by quantity/revenue, long-tail products, zero-sales products, or merchandising prioritization.
## Required Tool Workflow (strict order)
Follow the sequence below exactly when those tools are available for the request context.
Run this sequence in order for every best-seller request:
1. Call `shop_list_orders` for the selected time window (`creation_date_from`, `creation_date_to`).
2. Call `shop_list_products` to fetch catalog metadata used for labeling and collection filtering.
3. If the user requested collection scoping, call `shop_list_collections` and apply the selected collection filter.
4. If top-ranked rows are missing labels/metadata, call `shop_get_product` only for those rows.
5. Return the fixed-format report with rankings and insights.
If the dataset is too large, narrow scope before continuing (shorter period, stricter filters) instead of blind full pagination.
## Input contract
- `period_days`: `7`, `30`, or `90` (default `30`)
- `top_n`: number of rows per ranking table