breadcrumb

Name: breadcrumb
Author: kostja94

753stars109forks

How to install breadcrumb?

kostja94/marketing-skills/breadcrumb

$npx -y skills add kostja94/marketing-skills --skill breadcrumb

Installs into the current project.

Summary

When the user wants to add, optimize, or audit breadcrumb navigation. Also use when the user mentions "breadcrumbs," "breadcrumb trail," "breadcrumb nav," "breadcrumb links," "path navigation," "site breadcrumb," "BreadcrumbList schema," "location-based breadcrumb," "attribute-ba

Files · 1

View on GitHub

SKILL.md

1	# Components: Breadcrumb Navigation
2
3	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.
4
5	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.
6
7	## Scope
8
9	- Breadcrumb UI: Visual trail (Home > Category > Page)
10	- BreadcrumbList schema: JSON-LD structured data for rich results
11	- Placement: Typically below header, above main content
12
13	## Breadcrumb Types
14
15	\| Type \| Use case \| Recommendation \|
16	\|------\|----------\|----------------\|
17	\| Location-based \| Reflects site hierarchy (Home > Blog > SEO > Page) \| Recommended — most SEO-friendly; clear structure \|
18	\| Attribute-based \| Shows product attributes (Home > Electronics > Phone > iPhone 15) \| E-commerce; product classification \|
19	\| Path-based \| Shows user's browsing path \| Avoid — different users, different paths; can cause confusion \|
20
21	Default: Use location-based for most sites. Use attribute-based for e-commerce product pages.
22
23	## Initial Assessment
24
25	Check for project context first: If `.claude/project-context.md` or `.cursor/project-context.md` exists, read it for site structure and key pages.
26
27	Identify:
28	1. Site structure: Hierarchy depth (e.g., Home > Category > Subcategory > Product)
29	2. Page types: Blog, e-commerce, docs, etc.
30	3. Multi-category: Products in multiple categories—need canonical path
31
32	## Best Practices
33
34	### Structure & Hierarchy
35
36	\| Practice \| Guideline \|
37	\|----------\|-----------\|
38	\| Depth \| 3–5 levels optimal; avoid very long trails \|
39	\| Anchor text \| Keyword-rich, human-readable; descriptive \|
40	\| Consistency \| Same pattern across all pages (blog, category, product) \|
41	\| Canonical path \| For items in multiple categories, define one canonical breadcrumb to avoid diluted link equity \|
42
43	### Schema (BreadcrumbList)
44
45	See schema-markup for BreadcrumbList requirements, JSON-LD example, and multiple paths. Schema must match visible breadcrumbs exactly.
46
47	### Placement & Design
48
49	\| Practice \| Guideline \|
50	\|----------\|-----------\|
51	\| Position \| Below nav bar or above page title; top of content area \|
52	\| Visual \| Smaller font, lighter color; avoid competing with main content \|
53	\| Separator \| Clear separator (>, /, ›); consistent across site \|
54	\| Naming \| Match page title or nav menu; concise, descriptive \|
55
56	### UX & Accessibility
57
58	\| Practice \| Guideline \|
59	\|----------\|-----------\|
60	\| Mobile \| Tappable; short, readable text; high contrast \|
61	\| Long trails \| Horizontal scroll container rather than truncating \|
62	\| Current page \| Last item non-linked; use `aria-current="page"` \|
63	\| Screen readers \| `nav` with `aria-label="Breadcrumb"`; proper landmark \|
64
65	### SEO Impact
66
67	- Internal linking: Breadcrumbs distribute link equity
68	- Crawlability: Helps crawlers understand taxonomy
69	- GEO: BreadcrumbList appears frequently on pages cited by Google AI Mode
70	- Note: Google removed visual breadcrumbs from mobile SERPs (Jan 2025) to save space, but schema and algorithmic value remain important for crawlers and AI. See serp-features for breadcrumb SERP display.
71
72	## Implementation
73
74	### Semantic HTML
75
76	```html
77	<nav aria-label="Breadcrumb">
78	<ol itemscope itemtype="https://schema.org/BreadcrumbList">
79	<li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
80	<a itemprop="item" href="https://example.com/"><span itemprop="name">Home</span></a>
81	<meta itemprop="position" content="1" />
82	</li>
83	<li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
84	<a itemprop="item" href="https://example.com/category/"><span itemprop="name">Category</span></a>
85	<meta itemprop="position" content="2" />
86	</li>
87	<li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem" aria-current="page">
88	<span itemprop="name">Current Page</span>
89	<meta itemprop="position" content="3" />
90	</li>
91	</ol>
92	</nav>
93	```
94
95	Implementation: Generate BreadcrumbList from route segments or page metadata. Ensure `item` URLs are absolute. Use `next-seo` BreadcrumbJsonLd or cust

People who liked this also viewed

6 picks

Type

breadcrumb

753stars109forks

View on GitHub

How to install breadcrumb?

kostja94/marketing-skills/breadcrumb

$npx -y skills add kostja94/marketing-skills --skill breadcrumb

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# Components: Breadcrumb Navigation
2
3	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.
4
5	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.
6
7	## Scope
8
9	- Breadcrumb UI: Visual trail (Home > Category > Page)
10	- BreadcrumbList schema: JSON-LD structured data for rich results
11	- Placement: Typically below header, above main content
12
13	## Breadcrumb Types
14
15	\| Type \| Use case \| Recommendation \|
16	\|------\|----------\|----------------\|
17	\| Location-based \| Reflects site hierarchy (Home > Blog > SEO > Page) \| Recommended — most SEO-friendly; clear structure \|
18	\| Attribute-based \| Shows product attributes (Home > Electronics > Phone > iPhone 15) \| E-commerce; product classification \|
19	\| Path-based \| Shows user's browsing path \| Avoid — different users, different paths; can cause confusion \|
20
21	Default: Use location-based for most sites. Use attribute-based for e-commerce product pages.
22
23	## Initial Assessment
24
25	Check for project context first: If `.claude/project-context.md` or `.cursor/project-context.md` exists, read it for site structure and key pages.
26
27	Identify:
28	1. Site structure: Hierarchy depth (e.g., Home > Category > Subcategory > Product)
29	2. Page types: Blog, e-commerce, docs, etc.
30	3. Multi-category: Products in multiple categories—need canonical path
31
32	## Best Practices
33
34	### Structure & Hierarchy
35
36	\| Practice \| Guideline \|
37	\|----------\|-----------\|
38	\| Depth \| 3–5 levels optimal; avoid very long trails \|
39	\| Anchor text \| Keyword-rich, human-readable; descriptive \|
40	\| Consistency \| Same pattern across all pages (blog, category, product) \|
41	\| Canonical path \| For items in multiple categories, define one canonical breadcrumb to avoid diluted link equity \|
42
43	### Schema (BreadcrumbList)
44
45	See schema-markup for BreadcrumbList requirements, JSON-LD example, and multiple paths. Schema must match visible breadcrumbs exactly.
46
47	### Placement & Design
48
49	\| Practice \| Guideline \|
50	\|----------\|-----------\|
51	\| Position \| Below nav bar or above page title; top of content area \|
52	\| Visual \| Smaller font, lighter color; avoid competing with main content \|
53	\| Separator \| Clear separator (>, /, ›); consistent across site \|
54	\| Naming \| Match page title or nav menu; concise, descriptive \|
55
56	### UX & Accessibility
57
58	\| Practice \| Guideline \|
59	\|----------\|-----------\|
60	\| Mobile \| Tappable; short, readable text; high contrast \|
61	\| Long trails \| Horizontal scroll container rather than truncating \|
62	\| Current page \| Last item non-linked; use `aria-current="page"` \|
63	\| Screen readers \| `nav` with `aria-label="Breadcrumb"`; proper landmark \|
64
65	### SEO Impact
66
67	- Internal linking: Breadcrumbs distribute link equity
68	- Crawlability: Helps crawlers understand taxonomy
69	- GEO: BreadcrumbList appears frequently on pages cited by Google AI Mode
70	- Note: Google removed visual breadcrumbs from mobile SERPs (Jan 2025) to save space, but schema and algorithmic value remain important for crawlers and AI. See serp-features for breadcrumb SERP display.
71
72	## Implementation
73
74	### Semantic HTML
75
76	```html
77	<nav aria-label="Breadcrumb">
78	<ol itemscope itemtype="https://schema.org/BreadcrumbList">
79	<li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
80	<a itemprop="item" href="https://example.com/"><span itemprop="name">Home</span></a>
81	<meta itemprop="position" content="1" />
82	</li>
83	<li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
84	<a itemprop="item" href="https://example.com/category/"><span itemprop="name">Category</span></a>
85	<meta itemprop="position" content="2" />
86	</li>
87	<li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem" aria-current="page">
88	<span itemprop="name">Current Page</span>
89	<meta itemprop="position" content="3" />
90	</li>
91	</ol>
92	</nav>
93	```
94
95	Implementation: Generate BreadcrumbList from route segments or page metadata. Ensure `item` URLs are absolute. Use `next-seo` BreadcrumbJsonLd or cust

People who liked this also viewed

6 picks

Type