Toc Generator
- 760 installs
- 787 repo stars
- Updated June 9, 2026
- kostja94/marketing-skills
toc-generator is a Claude Code skill that generates, optimizes, and audits tables of contents for long-form articles, guides, and documentation so developers can improve navigation and SEO structure.
About
toc-generator is a marketing and documentation skill for building and auditing tables of contents on long-form articles, technical guides, and docs sites. It helps developers and technical writers produce hierarchical heading structures, anchor-friendly jump links, and scannable outlines that improve on-page navigation and search-friendly content organization. The skill supports generating TOCs from existing drafts, optimizing heading depth and labels, and auditing whether a page’s outline matches reader intent and SEO best practices. Reach for toc-generator when publishing lengthy README chapters, blog posts, or product docs where a clear TOC reduces bounce and helps search engines understand section hierarchy.
- Generates SEO-friendly TOCs for 1000+ word content
- Assesses project context from .claude/project-context.md or .cursor/project-context.md
- Evaluates content type, length, and platform before creating TOC
- Provides placement strategies including after intro and floating sidebar
- Optimizes for UX, navigation, and reduced bounce rates
Toc Generator by the numbers
- 760 all-time installs (skills.sh)
- +6 installs in the week ending Jul 25, 2026 (Skillselion tracking)
- Ranked #608 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Jul 31, 2026 (Skillselion catalog sync)
npx skills add https://github.com/kostja94/marketing-skills --skill toc-generatorAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 760 |
|---|---|
| repo stars | ★ 787 |
| Security audit | 3 / 3 scanners passed |
| Last updated | June 9, 2026 |
| Repository | kostja94/marketing-skills ↗ |
How do you optimize a table of contents for SEO?
Generate, optimize, and audit tables of contents for long-form articles, guides, and documentation.
Who is it for?
Developers and technical writers publishing long guides or documentation who need structured TOCs with SEO-friendly headings and jump links.
Skip if: Teams needing full local SEO, Google Business Profile setup, or citation management instead of on-page TOC structure.
When should I use this skill?
User mentions table of contents, TOC audit, heading hierarchy, jump links, or long-form article navigation structure.
What you get
Optimized table of contents with hierarchical headings, anchor links, and audit notes for long-form content.
- Generated TOC markup
- Heading audit report
- Optimized anchor-link outline
Files
SEO: Local
Guides local SEO: Google Business Profile, NAP consistency, and citation building. Businesses with accurate NAP across 40+ authoritative sites see ~19% higher visibility in Google Maps. Use this skill when optimizing for local search, setting up GBP, or auditing citations.
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 Sections 4 (Audience), 5 (Website).
Identify: 1. Business type: Storefront vs service-area 2. Location: Single or multiple 3. Current listings: Existing GBP, directories
NAP Consistency
NAP = Name, Address, Phone. Critical for local rankings.
| Rule | Guideline |
|---|---|
| Exact match | "Street" vs "St." or "LLC" inconsistency = Google may treat as different entities |
| Fix first | Audit and fix inconsistencies before adding new citations |
| Tools | BrightLocal, Whitespark, Moz Local for audit |
Google Business Profile
| Element | Guideline |
|---|---|
| Address | Physical address; no P.O. boxes |
| Description | 750 chars; primary keywords in first 100 |
| Hours | Accurate; seasonal availability |
| Category | Primary category matches business type |
| Service-area | Hide address if no storefront; define service areas |
Citation Building
Targeted precision over submitting to every directory.
Priority order: 1. Google Business Profile 2. Apple Maps 3. Yelp, Bing Places, Facebook 4. Better Business Bureau, Foursquare, Nextdoor 5. Niche directories (Healthgrades, Angi, etc.)
Citation Audit
- Incorrect or outdated data
- Duplicate entries
- Missing listings on key directories
Fix before adding; compounding errors harm rankings.
Output Format
- NAP (exact format for consistency)
- GBP optimization checklist
- Citation priority list
- Audit findings (if applicable)
Related Skills
- geo: GEO for AI search; local + AI overlap
- localization-strategy: Multilingual; local + i18n
- directory-submission: Directory listings; different from local citations
Related skills
Seo AuditRun structured SEO audits on their SaaS site or content hub and receive a prioritized action plan.173k42.2kCopywritingGenerate, rewrite, or strengthen persuasive website and landing-page copy that converts visitors into users.164k42.2k
Viral Short FormQuickly generate high-retention hooks, scripts, and outlines for TikTok, Reels, YouTube Shorts, and carousels.132k67Viral HooksWrite and critique viral hooks for short-form video opening sequences.123k67Viral Captions And CtasOptimize social media captions and CTAs for viral short-form video reach and saves.123k67Viral Youtube ShortsWrite and diagnose YouTube Shorts for Shorts Feed and long-form funnel.123k67How it compares
Pick toc-generator for on-page TOC structure and heading audits rather than local SEO or programmatic landing-page generation skills.
FAQ
What content types does toc-generator support?
toc-generator targets long-form articles, guides, and documentation where a structured table of contents improves navigation and SEO. The skill focuses on generating, optimizing, and auditing heading hierarchies rather than writing the full article body.
Why audit a table of contents before publishing?
toc-generator audits whether heading depth, labels, and anchor links match reader scanning behavior and search-friendly structure. A clear TOC helps users jump to sections and signals document hierarchy to crawlers on lengthy technical pages.
Is Toc Generator safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.