← Back to Skills Marketplace
150
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install markdown-toc
Description
Generate a table of contents from Markdown headings with configurable levels, formats, and unique anchors, excluding headings inside code blocks.
Usage Guidance
This skill appears to do exactly what it says: local processing of Markdown files to generate a TOC. Before installing, ensure your environment has Python available (the SKILL.md calls 'python'), and only pass files you trust (the script will read the input file and optionally write the output path you provide). There are no network calls or secret/env var requirements. If you want to be extra cautious, inspect the included markdown_toc.py (present here) and run it manually on a sample file to confirm behavior before allowing autonomous agent invocation.
Capability Analysis
Type: OpenClaw Skill
Name: markdown-toc
Version: 1.0.0
The markdown-toc skill is a straightforward utility for generating a Table of Contents from Markdown files. The core logic in markdown_toc.py uses standard Python libraries (argparse, re, pathlib) to parse headings and format them without any network activity, suspicious file access, or code execution risks. The instructions in SKILL.md are well-aligned with the tool's stated purpose and contain no evidence of prompt injection or malicious intent.
Capability Assessment
Purpose & Capability
Name/description align with the included script and README. The Python script implements heading extraction, slug generation, duplicate handling, and output formatting as described.
Instruction Scope
SKILL.md instructs running the included Python script against a user-supplied file and only reads/writes the specified input/output paths. It explicitly avoids headings inside code blocks. Minor note: the instructions reference an installation path (~/.openclaw/skills/markdown-toc/markdown_toc.py) which assumes the skill is installed there; otherwise README uses a relative invocation. No instructions ask the agent to read unrelated files or env vars.
Install Mechanism
There is no install spec (instruction-only) and the repository contains a single small Python script. No downloads or external installers are used.
Credentials
The skill declares no required environment variables or credentials. Minor inconsistency: SKILL.md/README show invoking the script with the 'python' command but required-binaries lists none; the platform will need Python available to run the script.
Persistence & Privilege
always is false and the skill does not request persistent system modifications or access to other skills/configs. disable-model-invocation is false (normal) so the agent could invoke it autonomously, but that is expected for user-invocable skills.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install markdown-toc - After installation, invoke the skill by name or use
/markdown-toc - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Generate table of contents from Markdown
Metadata
Frequently Asked Questions
What is Markdown TOC?
Generate a table of contents from Markdown headings with configurable levels, formats, and unique anchors, excluding headings inside code blocks. It is an AI Agent Skill for Claude Code / OpenClaw, with 150 downloads so far.
How do I install Markdown TOC?
Run "/install markdown-toc" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Markdown TOC free?
Yes, Markdown TOC is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Markdown TOC support?
Markdown TOC is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Markdown TOC?
It is built and maintained by haidong (@harrylabsj); the current version is v1.0.0.
More Skills