{"id":"5289b545-0aa5-4249-9e1a-255ed872e85e","shortId":"F6nddD","kind":"skill","title":"Generate Markdown tables of contents before publishing docs or README updates","tagline":"Runs DocToc to insert or refresh navigable tables of contents inside Markdown files after headings already exist. Use it when an agent is preparing README or docs updates and needs reliable intra-document navigation, not when it is generating the documentation itself.","description":"# Generate Markdown tables of contents before publishing docs or README updates\n\nRuns DocToc to insert or refresh navigable tables of contents inside Markdown files after headings already exist. Use it when an agent is preparing README or docs updates and needs reliable intra-document navigation, not when it is generating the documentation itself.\n\n## Prerequisites\n\nNode.js, npm, command line\n\n## Installation\n\nUse the upstream install or setup path that matches your environment:\n- npm install -g doctoc\n\nRequirements and caveats from upstream:\n- # DocToc [![Node.js CI](https://github.com/thlorenz/doctoc/actions/workflows/node.js.yml/badge.svg)](https://github.com/thlorenz/doctoc/actions/workflows/node.js.yml)\n- [Docker image](#docker-image)\n- ### Docker image\n\nBasic usage or getting-started notes:\n- <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->\n- [Usage](#usage)\n- [Example](#example)\n\n- Source: https://github.com/thlorenz/doctoc\n- Extracted from upstream docs: https://raw.githubusercontent.com/thlorenz/doctoc/HEAD/README.md\n\n## Documentation\n\n- https://github.com/thlorenz/doctoc#readme\n\n## Source\n\n- [Agent Skill Exchange](https://agentskillexchange.com/skills/generate-markdown-tables-of-contents-before-publishing-docs-or-readme-updates/)","tags":["generate","markdown","tables","contents","before","publishing","docs","readme","updates","skills","agentskillexchange","agent-skills"],"capabilities":["skill","source-agentskillexchange","skill-generate-markdown-tables-of-contents-before-publishing-docs-or-readme-updates","topic-agent-skills","topic-ai-agents","topic-ai-tools","topic-awesome-list","topic-claude-code","topic-codex","topic-cursor","topic-llm","topic-mcp","topic-npx-skills","topic-openclaw","topic-skills-catalog"],"categories":["skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/agentskillexchange/skills/generate-markdown-tables-of-contents-before-publishing-docs-or-readme-updates","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add agentskillexchange/skills","source_repo":"https://github.com/agentskillexchange/skills","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 8 github stars · SKILL.md body (1,276 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:10:34.313Z","embedding":null,"createdAt":"2026-05-18T13:16:41.500Z","updatedAt":"2026-05-18T19:10:34.313Z","lastSeenAt":"2026-05-18T19:10:34.313Z","tsv":"'/skills/generate-markdown-tables-of-contents-before-publishing-docs-or-readme-updates/)':180 '/thlorenz/doctoc':162 '/thlorenz/doctoc#readme':173 '/thlorenz/doctoc/actions/workflows/node.js.yml/badge.svg)](https://github.com/thlorenz/doctoc/actions/workflows/node.js.yml)':140 '/thlorenz/doctoc/head/readme.md':169 'agent':33,87,175 'agentskillexchange.com':179 'agentskillexchange.com/skills/generate-markdown-tables-of-contents-before-publishing-docs-or-readme-updates/)':178 'alreadi':27,81 'basic':148 'caveat':132 'ci':137 'command':112 'content':5,21,59,75 'doc':8,38,62,92,166 'docker':141,144,146 'docker-imag':143 'doctoc':13,67,129,135 'document':45,53,99,107,170 'environ':125 'exampl':157,158 'exchang':177 'exist':28,82 'extract':163 'file':24,78 'g':128 'generat':1,51,55,105 'get':152 'getting-start':151 'github.com':139,161,172 'github.com/thlorenz/doctoc':160 'github.com/thlorenz/doctoc#readme':171 'github.com/thlorenz/doctoc/actions/workflows/node.js.yml/badge.svg)](https://github.com/thlorenz/doctoc/actions/workflows/node.js.yml)':138 'head':26,80 'imag':142,145,147 'insert':15,69 'insid':22,76 'instal':114,118,127 'intra':44,98 'intra-docu':43,97 'line':113 'markdown':2,23,56,77 'match':123 'navig':18,46,72,100 'need':41,95 'node.js':110,136 'note':154 'npm':111,126 'path':121 'prepar':35,89 'prerequisit':109 'publish':7,61 'raw.githubusercontent.com':168 'raw.githubusercontent.com/thlorenz/doctoc/head/readme.md':167 'readm':10,36,64,90 'refresh':17,71 'reliabl':42,96 'requir':130 'run':12,66 'setup':120 'skill':176 'skill-generate-markdown-tables-of-contents-before-publishing-docs-or-readme-updates' 'sourc':159,174 'source-agentskillexchange' 'start':153 'tabl':3,19,57,73 'topic-agent-skills' 'topic-ai-agents' 'topic-ai-tools' 'topic-awesome-list' 'topic-claude-code' 'topic-codex' 'topic-cursor' 'topic-llm' 'topic-mcp' 'topic-npx-skills' 'topic-openclaw' 'topic-skills-catalog' 'updat':11,39,65,93 'upstream':117,134,165 'usag':149,155,156 'use':29,83,115","prices":[{"id":"1055bff9-57fa-4212-83fb-a810cd04cb53","listingId":"5289b545-0aa5-4249-9e1a-255ed872e85e","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"agentskillexchange","category":"skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:16:41.500Z"}],"sources":[{"listingId":"5289b545-0aa5-4249-9e1a-255ed872e85e","source":"github","sourceId":"agentskillexchange/skills/generate-markdown-tables-of-contents-before-publishing-docs-or-readme-updates","sourceUrl":"https://github.com/agentskillexchange/skills/tree/main/skills/generate-markdown-tables-of-contents-before-publishing-docs-or-readme-updates","isPrimary":false,"firstSeenAt":"2026-05-18T13:16:41.500Z","lastSeenAt":"2026-05-18T19:10:34.313Z"}],"details":{"listingId":"5289b545-0aa5-4249-9e1a-255ed872e85e","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"agentskillexchange","slug":"generate-markdown-tables-of-contents-before-publishing-docs-or-readme-updates","github":{"repo":"agentskillexchange/skills","stars":8,"topics":["agent-skills","ai-agents","ai-tools","awesome-list","claude-code","codex","cursor","llm","mcp","npx-skills","openclaw","skills-catalog"],"license":"mit","html_url":"https://github.com/agentskillexchange/skills","pushed_at":"2026-05-18T19:02:17Z","description":"The open catalog of AI agent skills — 2,000+ security-scanned skills for Claude Code, Cursor, Codex, and more.","skill_md_sha":"25bc2fa14b3e219492d24684ecb61b78d18d06a4","skill_md_path":"skills/generate-markdown-tables-of-contents-before-publishing-docs-or-readme-updates/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/agentskillexchange/skills/tree/main/skills/generate-markdown-tables-of-contents-before-publishing-docs-or-readme-updates"},"layout":"multi","source":"github","category":"skills","frontmatter":{"name":"Generate Markdown tables of contents before publishing docs or README updates","description":"Runs DocToc to insert or refresh navigable tables of contents inside Markdown files after headings already exist. Use it when an agent is preparing README or docs updates and needs reliable intra-document navigation, not when it is generating the documentation itself."},"skills_sh_url":"https://skills.sh/agentskillexchange/skills/generate-markdown-tables-of-contents-before-publishing-docs-or-readme-updates"},"updatedAt":"2026-05-18T19:10:34.313Z"}}