/category-pages
When the user wants to create, optimize, or audit e-commerce category pages or listing pages. Also use when the user mentions "category page," "product category," "faceted navigation," "filter URLs," "e-commerce listing," "category SEO," "category structure," "product filters,"
$ npx -y skills add kostja94/marketing-skills --skill category-pages --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/category-pages
Context preview
The summary Claude sees to decide when to auto-load this skill.
When the user wants to create, optimize, or audit e-commerce category pages or listing pages. Also use when the user mentions "category page," "product category," "faceted navigation," "filter URLs," "e-commerce listing," "category SEO," "category structure," "product filters,"
SKILL.md
category-pages.SKILL.mdname: category-page-generator
description: When the user wants to create, optimize, or audit e-commerce category pages or listing pages. Also use when the user mentions "category page," "product category," "faceted navigation," "filter URLs," "e-commerce listing," "category SEO," "category structure," "product filters," or "listing page." For programmatic SEO at scale, use programmatic-seo.
metadata:
version: 1.0.1
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 layout; responsive columns
- **products-page-generator**: Product cards, grid layout
- **canonical-tag**: Faceted URL canonicalization
- **schema-markup**: ItemList, Product, FAQ schema
- **internal-links**: Category linking
- **breadcrumb-generator**: Breadcrumb trail for category hierarchy
- **url-structure**: URL hierarchy
Read more
name: category-page-generator description: When the user wants to create, optimize, or audit e-commerce category pages or listing pages. Also use when the user mentions "category page," "product category," "faceted navigation," "filter URLs," "e-commerce listing," "category SEO," "category structure," "product filters," or "listing page." For programmatic SEO at scale, use programmatic-seo. metadata: version: 1.0.1
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 layout; responsive columns
- **products-page-generator**: Product cards, grid layout
- **canonical-tag**: Faceted URL canonicalization
- **schema-markup**: ItemList, Product, FAQ schema
- **internal-links**: Category linking
- **breadcrumb-generator**: Breadcrumb trail for category hierarchy
- **url-structure**: URL hierarchy
Markdown skill library for AI agents - SEO, content, pages, paid ads, channels, strategies. Add project context + skills; your agent delivers tailored, production-ready output. Works with Cursor, Claude Code, OpenClaw, Lovable, and any AI that reads markdown.
Repo: kostja94/marketing-skills
Other skills on kostja94-marketing-skills.
- /google-search-console
When the user wants to analyze Google Search Console data, use the GSC API, or interpret search performance. Also use when the user mentions "GSC," "Search Console," "indexing report," "Core Web Vitals," "Enhancements," "Insights report," "search performance," "search queries,"
Open skill - /seo-monitoring
When the user wants to build an SEO data analysis system, monitor indexing/traffic/keywords/backlinks, or set up benchmarks. Also use when the user mentions "SEO data analysis," "SEO monitoring," "article database," "traffic benchmark," "penalty recovery," "SEO work document,"
Open skill - /ai-traffic
When the user wants to track AI search traffic in GA4 or GSC. Also use when the user mentions "AI traffic," "ChatGPT referral," "Perplexity traffic," "AI Overviews," "GA4 AI sources," "AI search analytics," "track AI referrals," "AI search traffic," "Claude traffic," or "how to
Open skill - /traffic
When the user wants to analyze website traffic sources, attribution, or dark traffic. Also use when the user mentions "traffic sources," "dark traffic," "direct traffic," "UTM parameters," "traffic attribution," "channel attribution," "attribution optimization," "channel
Open skill - /tracking
When the user wants to set up, audit, or optimize analytics tracking (GA4, events, conversions). Also use when the user mentions "Google Analytics," "GA4," "event tracking," "conversions," "attribution model," "gtag," "data layer," "GA4 setup," "conversion tracking," "event
Open skill - /community-forum
When the user wants to promote via forums, communities, or invite users to join a community. Also use when the user mentions "forum promotion," "Indie Hacker," "Hacker News," "community growth," "Discord promotion," "vertical community," "brand encyclopedia," "Wikipedia,"
Open skill