markdown-toc
Generate Markdown Tables of Contents
Large Markdown projects become hard to navigate when headings change. This skill helps generate, preview, and update tables of contents across files.
Install with my Agent
Copy this request to your Agent. It includes the canonical Skill page and manifest.
Review the Skillstore skill "markdown-toc" from https://skillstore.io/skills/emasoft-markdown-toc.md and its manifest at https://skillstore.io/api/skills/emasoft-markdown-toc/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.Your Agent should still show its plan and request any confirmation required by the security policy.
Agent-readable resources
Use these links when an AI agent, crawler, or script needs clean context instead of reading the full page.
Test it
Using "markdown-toc". A README with Installation, Usage, Advanced Usage, and Contributing headings.
Expected outcome:
A titled table of contents with nested links that match the heading hierarchy.
Using "markdown-toc". A docs folder containing several Markdown guides.
Expected outcome:
A preview showing each processed file, the generated table of contents, and the heading count.
Using "markdown-toc". A guide with explicit table of contents markers.
Expected outcome:
The content between the markers is replaced while surrounding text remains unchanged.
Security Audit
SafeAll static findings are Markdown code fences or inline code formatting, not executable Ruby or shell backtick usage. No prompt injection, data exfiltration intent, network access, or secret handling was found in SKILL.md.
Risk Factors
⚙️ External commands (65)
Share & cite this report
Share the versioned assessment report, neutral badge, embed card, and citations. Skillstore reports evidence without deciding whether this Skill is safe.
Copy report link
https://skillstore.io/skills/emasoft-markdown-toc/audits/9?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_reportMarkdown badge
[](https://skillstore.io/skills/emasoft-markdown-toc?utm_source=security_passport_badge)HTML badge
<a href="https://skillstore.io/skills/emasoft-markdown-toc?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/emasoft-markdown-toc/security.svg" alt="Skillstore security assessment" loading="lazy"></a>Embed card
<iframe src="https://skillstore.io/embed/skills/emasoft-markdown-toc.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>Academic citations (APA · BibTeX · CFF)
APA citation
Emasoft. (2026). markdown-toc security audit report (audit version 9) [Author version unspecified]. Skillstore. https://skillstore.io/skills/emasoft-markdown-toc/audits/9BibTeX citation
@techreport{emasoft-emasoft-markdown-toc-2026,
author = {Emasoft},
title = {markdown-toc security audit report (audit version 9)},
institution = {Skillstore},
year = {2026},
number = {9},
url = {https://skillstore.io/skills/emasoft-markdown-toc/audits/9},
note = {Author version unspecified}
}CITATION.cff
cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "markdown-toc security audit report (audit version 9)"
version: "unspecified"
type: report
authors:
- name: "Emasoft"
date-released: "2026-07-06"
url: "https://skillstore.io/skills/emasoft-markdown-toc/audits/9"
identifiers:
- type: other
value: "skillstore:emasoft-markdown-toc:audit:9"
description: "Skillstore immutable audit report identifier"
Skillstore Score
Why this score Evidence Confidence: HighWhat You Can Build
Refresh Project Documentation
Update README and docs tables of contents after headings change.
Prepare Open Source Releases
Preview and standardize navigation links before publishing release notes or guides.
Organize Large Doc Sets
Apply consistent table of contents settings across folders and guide collections.
Try These Prompts
Generate a table of contents preview for README.md. Use the default heading levels and explain where it will be inserted.
Preview table of contents updates for all Markdown files in docs. Then list the files that would change.
Generate a table of contents for README.md using headings from level 1 through level 4. Preview the result before editing.
Update tables of contents between explicit markers across docs. Use recursive processing and show any files without matching markers.
Best Practices
- Run a dry run before applying changes to project documentation.
- Use marker mode when each file needs a precise replacement location.
- Review generated links when documents contain repeated or unusual headings.
Avoid
- Do not run recursive updates without checking the preview first.
- Do not mix different heading level rules across related documentation without a reason.
- Do not rely on automatic placement when a document has a strict template.
Frequently Asked Questions
What does this skill help automate?
Can it preview changes before editing files?
Can it process more than one file?
Can I control which heading levels appear?
Where can the table of contents be inserted?
Does it require external services?
Developer Details
Author
EmasoftLicense
MIT
Skillstore revision
r1
Version notice
The author did not declare a version.
Repository
https://github.com/Emasoft/ghe-marketplace/tree/main/plugins/marketplace-utils/skills/markdown-tocRef
72d5025b022c77f7a51bdf5c1637c689c80e89d1
Maintenance freshness
7/18/2026
Usage
5 downloads · 208 views
File structure
📄 SKILL.md