toc-generator

# Components: Table of Contents (TOC) Guides TOC implementation for long-form articles, guides, and whitepapers. TOCs improve UX and SEO by enabling quick navigation and reducing bounce rates. **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 content structure. Identify: 1. **Content type**: Blog article, guide, whitepaper, documentation 2. **Length**: TOC most valuable for 1000+ word content 3. **Platform**: Web, mobile, both ## Placement Strategies | Placement | Best For | Pros | Cons | |-----------|----------|------|------| | **After intro** | Most articles | Natural flow; visible early | Can scroll out of view | | **Floating sidebar** | Very long content | Always visible | More complex; mobile challenges | | **Collapsible** | Long articles | Less intrusive | May be overlooked | | **Top of article** | Mobile-first | Accessible on all devices | Takes space | ## Technical Implementation ### Heading Structure - One `<h1>` per page - `<h2>` for major sections - `<h3>` for subsections; avoid skipping levels - Headings >=15 characters for SEO ### Jump Links - Assign unique IDs to headings (e.g., `id="keyword-optimization"`) - Use kebab-case for I...