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.
- Filters & facets — the filters shoppers need (price, size, colour, brand, attribute), and which should be crawlable vs. noindex to avoid thin/duplicate pages.
- Internal linking — links to subcategories, related categories, and key products; breadcrumb structure.
- Trust & conversion elements — reviews/ratings on cards, badges, shipping/returns reassurance, a strong category image.
- SEO / technical notes — title tag & meta description, canonical strategy for filtered URLs, pagination, and structured data.
- Supporting content — an optional bottom-of-page FAQ/buying-guide block for long-tail terms.
Mark inferred keywords/inventory (confirm).
Quality Checks
Anti-Patterns
Based On
E-commerce SEO & merchandising practice — intent-driven category pages, faceted-navigation crawl control, default-sort strategy, and on-page/technical SEO.
1---2name: category-page-brief-23description: "Plan an e-commerce category / collection page that ranks and merchandises well. Use when asked to design a category page, a PLP (product listing page), a collection page, or to improve category SEO and merchandising. Produces a brief — search intent & keywords, intro copy, merchandising/sort logic, filters & facets, internal links, and SEO/technical notes — so the page converts browsers and earns organic traffic."4homepage: https://mohitagw15856.github.io/pm-claude-skills/skill/category-page-brief.html5metadata:6 source: https://skillmd.com/skills/mohitagw15856/category-page-brief-27 openclaw:8 emoji: 🛒9---1011# Category Page Brief Skill1213Category pages are the workhorses of e-commerce SEO and discovery — they rank for high-intent "buy" searches14and decide what a browsing shopper sees first. A good one balances **search relevance** (the right keywords,15copy, and structure) with **merchandising** (the right products, order, and filters). This skill briefs that16page so it earns traffic and converts it.1718## Working from a brief1920Given "a category page for women's running shoes", **produce the full brief anyway** — infer the search intent,21likely keywords, sensible filters, and merchandising logic, marking inferences. Don't invent search volumes or22inventory; flag them to confirm. Never withhold for missing detail.2324## Required Inputs2526Ask for these only if they aren't already provided (else infer and label):2728- **The category** — what it covers, and where it sits in the catalogue hierarchy.29- **The shopper & intent** — who lands here and what they're trying to do (browse vs. specific need).30- **Inventory & attributes** — roughly what products/variants exist and their key attributes (for filters).31- **SEO context** — target keywords if known, and the platform (Shopify, Magento, custom).3233## Output Format3435### Category Page Brief: [category]3637- **Search intent & keywords** — the primary head term, secondary/long-tail terms, and the intent (commercial). Note any to validate with real volume.38- **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.39- **Merchandising & default sort** — what shows first (bestsellers, new, margin, seasonal) and the rule behind it; promoted/pinned products; out-of-stock handling.40- **Filters & facets** — the filters shoppers need (price, size, colour, brand, attribute), and which should be crawlable vs. noindex to avoid thin/duplicate pages.41- **Internal linking** — links to subcategories, related categories, and key products; breadcrumb structure.42- **Trust & conversion elements** — reviews/ratings on cards, badges, shipping/returns reassurance, a strong category image.43- **SEO / technical notes** — title tag & meta description, canonical strategy for filtered URLs, pagination, and structured data.44- **Supporting content** — an optional bottom-of-page FAQ/buying-guide block for long-tail terms.4546Mark inferred keywords/inventory *(confirm)*.4748## Quality Checks4950- [ ] Target keyword and search intent are explicit and reflected in H1, intro, and title tag51- [ ] Intro copy serves shoppers and SEO without pushing products below the fold52- [ ] A default sort/merchandising rule is defined with its rationale53- [ ] Filter/facet strategy addresses crawlability (avoids thin/duplicate filtered pages)54- [ ] Internal linking and breadcrumbs connect the page into the catalogue55- [ ] Technical SEO (title/meta, canonical, pagination, structured data) is covered; invented data flagged5657## Anti-Patterns5859- [ ] Do not dump a keyword-stuffed paragraph above the products — it hurts UX and rankings60- [ ] Do not let every filter combination create an indexable URL — that spawns thin/duplicate pages61- [ ] Do not default-sort by accident — choose and justify the order shoppers see first62- [ ] Do not invent search volume or inventory — flag for validation63- [ ] Do not ignore out-of-stock handling — dead-end products lose the click and the ranking6465## Based On6667E-commerce SEO & merchandising practice — intent-driven category pages, faceted-navigation crawl control, default-sort strategy, and on-page/technical SEO.