From kostja94-marketing-skills-5
Guides implementation of breadcrumb navigation for websites, including UI trails, location/attribute-based types, BreadcrumbList schema, SEO best practices, hierarchy, and placement.
npx claudepluginhub joshuarweaver/cascade-data-analytics --plugin kostja94-marketing-skills-5This skill uses the workspace's default tool permissions.
Guides breadcrumb implementation for SEO, UX, and GEO. Breadcrumbs show users their location in the site hierarchy and help search engines understand content taxonomy. Well-implemented breadcrumbs can increase CTR by 20–30%, reduce bounce rates by up to 30%, and strengthen internal linking.
Conducts multi-round deep research on GitHub repos via API and web searches, generating markdown reports with executive summaries, timelines, metrics, and Mermaid diagrams.
Dynamically discovers and combines enabled skills into cohesive, unexpected delightful experiences like interactive HTML or themed artifacts. Activates on 'surprise me', inspiration, or boredom cues.
Generates images from structured JSON prompts via Python script execution. Supports reference images and aspect ratios for characters, scenes, products, visuals.
Guides breadcrumb implementation for SEO, UX, and GEO. Breadcrumbs show users their location in the site hierarchy and help search engines understand content taxonomy. Well-implemented breadcrumbs can increase CTR by 20–30%, reduce bounce rates by up to 30%, and strengthen internal linking.
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.
| Type | Use case | Recommendation |
|---|---|---|
| Location-based | Reflects site hierarchy (Home > Blog > SEO > Page) | Recommended — most SEO-friendly; clear structure |
| Attribute-based | Shows product attributes (Home > Electronics > Phone > iPhone 15) | E-commerce; product classification |
| Path-based | Shows user's browsing path | Avoid — different users, different paths; can cause confusion |
Default: Use location-based for most sites. Use attribute-based for e-commerce product pages.
Check for project context first: If .claude/project-context.md or .cursor/project-context.md exists, read it for site structure and key pages.
Identify:
| Practice | Guideline |
|---|---|
| Depth | 3–5 levels optimal; avoid very long trails |
| Anchor text | Keyword-rich, human-readable; descriptive |
| Consistency | Same pattern across all pages (blog, category, product) |
| Canonical path | For items in multiple categories, define one canonical breadcrumb to avoid diluted link equity |
See schema-markup for BreadcrumbList requirements, JSON-LD example, and multiple paths. Schema must match visible breadcrumbs exactly.
| Practice | Guideline |
|---|---|
| Position | Below nav bar or above page title; top of content area |
| Visual | Smaller font, lighter color; avoid competing with main content |
| Separator | Clear separator (>, /, ›); consistent across site |
| Naming | Match page title or nav menu; concise, descriptive |
| Practice | Guideline |
|---|---|
| Mobile | Tappable; short, readable text; high contrast |
| Long trails | Horizontal scroll container rather than truncating |
| Current page | Last item non-linked; use aria-current="page" |
| Screen readers | nav with aria-label="Breadcrumb"; proper landmark |
<nav aria-label="Breadcrumb">
<ol itemscope itemtype="https://schema.org/BreadcrumbList">
<li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
<a itemprop="item" href="https://example.com/"><span itemprop="name">Home</span></a>
<meta itemprop="position" content="1" />
</li>
<li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
<a itemprop="item" href="https://example.com/category/"><span itemprop="name">Category</span></a>
<meta itemprop="position" content="2" />
</li>
<li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem" aria-current="page">
<span itemprop="name">Current Page</span>
<meta itemprop="position" content="3" />
</li>
</ol>
</nav>
Implementation: Generate BreadcrumbList from route segments or page metadata. Ensure item URLs are absolute. Use next-seo BreadcrumbJsonLd or custom component. See schema-markup for JSON-LD structure.
| Site type | Use case |
|---|---|
| E-commerce | Category > Subcategory > Product |
| Blog | Home > Blog > Category > Post (see article-page-generator for article page structure) |
| Docs | Home > Docs > Section > Page |
| Large sites | Any site with 3+ level hierarchy |
Skip on flat sites (e.g., single-page, 1–2 level depth).
Deep pages: For 6+ levels, consider omitting middle levels; show only the most important categories to avoid clutter.
| Platform | Options |
|---|---|
| WordPress | Yoast SEO, Rank Math, Breadcrumb NavXT |
| Next.js | next-seo BreadcrumbJsonLd, custom from route segments |
| Shopify, Drupal, Joomla | Built-in or plugin support |
| Error | Fix |
|---|---|
| Relative URLs in schema | Use absolute URLs (https://) |
| Schema doesn't match visible trail | Keep schema and UI in sync |
| Missing position | Include sequential position (1, 2, 3…) |
| Last item linked | Current page typically not a link |
| Too many levels | Limit to 5–7; omit middle levels for deep paths |
| Inaccurate path | Breadcrumb must reflect actual site structure |
| No schema | Add BreadcrumbList per schema-markup; otherwise no SERP breadcrumbs; see serp-features |