SKILL.md
Category Page Brief Skill
Category pages are the workhorses of e-commerce SEO and discovery — they rank for high-intent "buy" searches and decide what a browsing shopper sees first. A good one balances search relevance (the right keywords, copy, and structure) with merchandising (the right products, order, and filters). This skill briefs that page so it earns traffic and converts it.
Working from a brief
Given "a category page for women's running shoes", produce the full brief anyway — infer the search intent, likely keywords, sensible filters, and merchandising logic, marking inferences. Don't invent search volumes or inventory; flag them to confirm. Never withhold for missing detail.
Required Inputs
Ask for these only if they aren't already provided (else infer and label):
- The category — what it covers, and where it sits in the catalogue hierarchy.
- The shopper & intent — who lands here and what they're trying to do (browse vs. specific need).
- Inventory & attributes — roughly what products/variants exist and their key attributes (for filters).
- SEO context — target keywords if known, and the platform (Shopify, Magento, custom).
Output Format
Category Page Brief: [category]
- Search intent & keywords — the primary head term, secondary/long-tail terms, and the intent (commercial). Note any to validate with real volume.
- Page H1 & intro copy — the H1 and a short (skimmable, keyword-aware) intro that helps shoppers and SEO — placed so it doesn't push products below the fold.
- Merchandising & default sort — what shows first (bestsellers, new, margin, seasonal) and the rule behind it; promoted/pinned products; out-of-stock handling.
