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.
npx skills add kostja94/marketing-skills --skill toc --agent cursor
Same command for any agent — swap --agent for claude-code, codex, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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 |
- Initial Assessment
- Placement Strategies
- Technical Implementation
- Heading Structure
- Jump Links
- Semantic HTML
- SEO Best Practices
- UX Guidelines
- Visibility & Interaction
- Mobile
- Accessibility
- Output Format
- Related Skills
What does the toc-generator skill do?
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.
How do I install it?
Run `npx skills add kostja94/marketing-skills --skill toc --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From kostja94/marketing-skills, a repository with 848 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.