Agent skill · writing content · kostja94
toc-generator
When the user wants to add, optimize, or audit table of contents (TOC) for long-form content. Also use when the user mentions "TOC," "table of contents," "table of contents for article," "article TOC," "jump links," "content outline," "article navigation," "in-page navigation," "add TOC to blog," or "TOC for long content." For article SEO template, use article-page-generator.
Why this skill is useful
Provides specific guidelines and best practices for implementing TOCs that enhance SEO and user experience, which the AI may not generate reliably on its own.
What it needs
About 2k tokens when loaded. Last updated 2026-06-09. 860 stars on the source repository.
What this skill does
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 IDs Link TOC entries via anchor tags (#section-id) Descriptive anchor text; include target keywords naturally Semantic HTML SEO Best Practices Practice Purpose ---------- --------- Schema.org TableOfContents Help search engines understand structure Keywords in headings Natural integration; avoid stuffing Jump links in SERP Google may feature TOC links; increases CTR; see serp-features UX Guidelines Visibility & Interaction Clear visual hierarchy; indent nested items Highlight current section when scrolling (optional) Smooth scroll behavior for jump links Mobile Minimum 16px font size Touch targets >=44x44px Responsive layout; consider collapsib …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills kostja94/toc