Category Page Generator
Structure, write, and SEO-tune e-commerce category and listing pages with sensible hierarchy, facets, and filter URLs.
Overview
category-page-generator is an agent skill for the Launch phase that designs and optimizes e-commerce category and listing pages for hierarchy, facets, filter URLs, and category SEO.
Install
npx skills add https://github.com/kostja94/marketing-skills --skill category-page-generatorWhat is this skill?
- Initial assessment for catalog size, facets (size, color, price, brand), and URL hierarchy
- Hierarchy table: logical grouping general→specific aligned to search intent
- Positions category pages to capture high-volume head terms vs product-detail pages
- Reads `.claude/project-context.md` or `.cursor/project-context.md` when present for catalog context
- Explicit handoff: programmatic-seo for large-scale programmatic category generation
- Skill cites category pages driving ~3x more organic revenue than product pages for broad keywords
- Metadata version 1.0.1
Adoption & trust: 763 installs on skills.sh; 586 GitHub stars; 3/3 security scanners passed (skills.sh audits).
What problem does it solve?
Your store has products and ad-hoc collections but category URLs, filters, and intent-aligned structure are not earning broad organic traffic or revenue.
Who is it for?
Indie e-commerce and DTC founders shipping on Shopify, custom stacks, or headless storefronts who own merchandising and SEO themselves.
Skip if: Pure B2B SaaS with no product catalog, single-product landers only, or teams that already have frozen taxonomy and only need one-off product copy.
When should I use this skill?
User wants to create, optimize, or audit e-commerce category or listing pages—or mentions category page, product category, faceted navigation, filter URLs, category SEO, product filters, or listing page.
What do I get? / Deliverables
You get a concrete category hierarchy, facet/URL plan, and SEO-oriented listing structure—and can hand off large-scale generation to programmatic-seo when scale demands it.
- Category hierarchy and subcategory map aligned to search intent
- Facet/filter and URL-structure recommendations
- Category-page content and SEO optimization checklist
Recommended Skills
Journey fit
Category pages are primarily an organic discovery and ranking surface—canonical placement is Launch where SEO and listing architecture are designed. Subphase seo matches broad commercial-intent keywords, faceted navigation, and on-page/category metadata called out in the skill.
How it compares
Use for merchandising category architecture and on-page SEO—not as a replacement for full-site programmatic URL factories (pair with programmatic-seo at scale).
Common Questions / FAQ
Who is category-page-generator for?
Solo builders and small teams running e-commerce sites who need category/listing pages that rank for broad keywords and support filters without SEO-breaking URL sprawl.
When should I use category-page-generator?
During Launch SEO when creating or auditing category pages, faceted navigation, filter URLs, or category structure—and before scaling many listing URLs (then add programmatic-seo).
Is category-page-generator safe to install?
It mainly guides structure and copy; review the Security Audits panel on this Prism page and your repo permissions before letting an agent read project-context files.
Workflow Chain
Then invoke: programmatic seo
SKILL.md
READMESKILL.md - Category Page Generator
# Pages: Category Pages Guides e-commerce category page structure, content, and SEO optimization. Category pages organize products by attributes and drive 3x more organic revenue than product pages by ranking for broad, high-volume keywords. **When invoking**: On **first use**, if helpful, open with 1-2 sentences on what this skill covers and why it matters, then provide the main output. On **subsequent use** or when the user asks to skip, go directly to the main output. ## Initial Assessment **Check for project context first:** If `.claude/project-context.md` or `.cursor/project-context.md` exists, read it for product catalog and site structure. Identify: 1. **Catalog**: Product count, categories, subcategories 2. **Facets**: Filters (size, color, price, brand, etc.) 3. **URL structure**: Current hierarchy, parameter handling ## Category Structure ### Hierarchy | Principle | Practice | |-----------|----------| | **Logical grouping** | General -> specific (e.g., Furniture -> Bedroom furniture -> Beds) | | **User search intent** | Match how users search (e.g., "bedroom furniture" vs "furniture") | | **Crawl depth** | <=4 clicks from homepage; shorter paths improve indexing | | **Long-tail categories** | Niche categories convert better (36% vs 11.5% for broad) | ### URL Structure - **Subfolders**: `example.com/shoes/sneakers`, `example.com/shoes/outdoor-shoes` - **Slugs**: Descriptive, keyword-rich; lowercase; no stop words - **Avoid**: Dates, timestamps, `/category/` prefix - **Breadcrumbs**: Show path; help users and crawlers ## Faceted Navigation (Filters) Filters create many URL combinations (size + color + price). Manage to avoid duplicate content and crawl waste: | Strategy | Use | |----------|-----| | **Canonical** | Point all faceted URLs to base category URL | | **robots.txt** | Block faceted URLs from indexing if needed | | **nofollow** | Add to internal links to faceted URLs | | **JavaScript** | Keep filters client-side; single URL for category | ## On-Page Content ### Content Requirements - **150-300 words** unique copy; pages with this rank ~2.7x higher than product-only grids - **Placement**: After hero/H1; FAQ block at bottom - **Purpose**: Help users decide; answer curation, materials, recommendations - **Avoid**: Manufacturer copy; crowding product grid ### SEO Elements | Element | Practice | |---------|----------| | **H1** | One per page; primary keyword; clear purpose | | **Title tag** | 50-60 chars; keyword; compelling for CTR | | **Meta description** | 150-160 chars; value props (free shipping, returns) | | **Schema** | ItemList, Product; AggregateRating if reviews; FAQ if applicable | ### Trust & Conversion - **Reviews**: Star ratings in SERPs; 99.9% of users read reviews; see **serp-features** for review rich results - **FAQ**: Answer materials, quality, recommendations; +157% conversion when used - **Guides**: Link to product guides; internal linking for SEO ## Technical - **Consistent layout**: Same template across categories; predictable UX - **Mobile**: Responsive; touch targets >=44x44px - **Redirects**: 301 to category when product pages move; avoid breaking hierarchy ## Output Format - **Structure** (hierarchy, URL paths) - **Facet strategy** (canonical, nofollow, robots) - **Content** (H1, intro copy, FAQ) - **SEO** (metadata, schema) - **Checklist** for audit ## Related Skills - **programmatic-seo**: Programmatic SEO strategy; category pages as template-based scale - **card**: Card layout; product card structure, grid design - **grid**: Product grid