breadcrumb-impl

Implement hierarchical breadcrumbs with semantic HTML5, ARIA attributes, and React Router integration.

Updated Aug 25, 2025
One-click install
npx skills add https://github.com/joaopelegrino/app-controle --skill breadcrumb-impl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: breadcrumb-impl
Source: https://github.com/joaopelegrino/app-controle/tree/main/.claude/skills/breadcrumb-impl
Command: npx skills add https://github.com/joaopelegrino/app-controle --skill breadcrumb-impl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a standardized, accessible solution for hierarchical navigation (breadcrumbs), ensuring compliance with WCAG 2.1 AA guidelines and consistent UI/UX across the platform. It eliminates the need for manual accessibility checks and design iterations.

Core Features & Use Cases

  • WCAG 2.1 AA Compliance: Generate semantic HTML (<nav>, <ol>, <li>) with correct ARIA attributes (aria-label, aria-current) for screen reader compatibility.
  • Responsive Design: Automatically implement mobile-friendly collapsing behavior (e.g., ... > Last Item) for optimal display on all devices.
  • React Component Integration: Provide a ready-to-use React component (Breadcrumb.jsx) with clear props for easy integration into various learning system views.
  • Use Case: Implement the breadcrumb for the "Curso de Bash" view, showing "Hub > Curso de Bash", and for "Aula 1.1", showing "Hub > Curso de Bash > Aula 1.1", ensuring all items are clickable except the current one.

Quick Start

Use the breadcrumb-impl skill to create the Breadcrumb.jsx component, integrating it into the BashLearningSystem.jsx component.

Frequently Asked Questions about breadcrumb-impl

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement accessible breadcrumb navigation that meets WCAG 2.1 AA standards?

Accessible breadcrumb navigation requires semantic HTML (`<nav>`, `<ol>`, `<li>`) with ARIA attributes (`aria-label`, `aria-current`). This skill provides a React component that generates screen-reader compatible breadcrumbs with correct ARIA markup, keyboard accessibility, and clickable ancestors—all compliant with WCAG 2.1 AA guidelines without manual accessibility checks.

Can I use a breadcrumb component with React Router for hierarchical navigation?

Yes. This skill includes optional React Router integration for breadcrumb components. It accepts hierarchical path data and integrates directly into React views, allowing you to implement breadcrumbs like "Hub > Curso de Bash > Aula 1.1" with clickable ancestors and current-item styling in learning management systems.

How do breadcrumbs handle responsive design on mobile devices?

Breadcrumb responsive design automatically collapses on mobile by hiding intermediate items and displaying an ellipsis (e.g., "... > Last Item"). This skill implements mobile-friendly collapse behavior through configurable separators and responsive styling, ensuring optimal display across all device sizes without manual media queries.

What are the semantic HTML requirements for breadcrumb navigation?

Breadcrumb navigation must use semantic HTML5: `<nav>` for the container, `<ol>` for the ordered list, and `<li>` for individual items. This structure, combined with ARIA attributes (`aria-label` for the nav, `aria-current="page"` for the active item), makes breadcrumbs accessible to screen readers and assistive technologies.

Do I need to manually style the current breadcrumb item differently?

No. This skill automatically applies bold styling to the current breadcrumb item and marks it with `aria-current`, making it visually and semantically distinct. You configure separators and styling through component props; the component handles the rest, reducing design iterations.