Skip to content
cccskills
FreePublished on GitHub

markdown-toc

Extract a heading tree with line numbers from a Markdown file before editing. Use it to understand a long document, find an appropriate section for new notes, and check nearby text before making changes.

OriginalShow the original description

Extract a Markdown heading tree with line numbers before editing or integrating notes. Use when you need to inspect a long Markdown file quickly and choose the best insertion point instead of editing blind.

See how to install

Good for

  • Reviewing the structure of a long Markdown document
  • Finding the right section for additional notes
  • Checking existing headings to avoid duplicate sections
  • Inspecting nearby text before editing a note

Files included (3)

  • SKILL.md1.5 KB
  • agents/openai.yaml289 B
  • scripts/extract_toc.py2.0 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Markdown TOC

Use this skill when

Use this skill before editing a long Markdown file, especially when you need to:

  • inspect the heading structure quickly;
  • choose the best section for new content;
  • avoid creating redundant sections; or
  • review nearby lines before patching a note.

Quick start

Resolve {baseDir} to this skill’s actual directory, then run the bundled script. It reports ATX (#) headings, excluding fenced code; Setext headings and full Markdown parsing are outside its scope:

python3 "{baseDir}/scripts/extract_toc.py" /absolute/path/to/file.md

In this repository, common targets include:

python3 "{baseDir}/scripts/extract_toc.py" Notes/Gourmet.md
python3 "{baseDir}/scripts/extract_toc.py" "Notes/AI-Agent-Product&PE.md"

Workflow

  1. Run the TOC script on the candidate file.
  2. Read the returned heading tree and line numbers.
  3. Open the most likely section neighborhood with sed -n '<start>,<end>p' or nl -ba.
  4. Insert into an existing section when possible.
  5. Create a new section only when the file truly lacks a clean landing spot.

Output format

The script prints a compact tree like this:

TOC
--------------------------------------------------
# Title (line 1)
  ## Section (line 20)
    ### Subsection (line 42)

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

ai-hotspots

FreeSummary

Gather recent AI products, papers, tools, and viewpoints into a Chinese and English HTML daily report. Select up to ten supported items, check original sources where possible, and summarize shared trends with practical next actions.

  • Reviewing recent AI developments each morning
  • Tracking research and tools for AI agents
  • Choosing what to read or try next
huangruiteng/CS-Notes4KUpdated Oct 20, 2026

Retrieve an arxiv paper's full text from its HTML version using an ID or URL. Extract readable text with section structure, optionally save it to a file, and prepare it for reading, notes, or technical analysis.

  • Reading a paper from an arxiv ID or URL
  • Extracting full text for research notes
  • Saving long papers for section-by-section reading
huangruiteng/CS-Notes4KUpdated Oct 20, 2026

ask-echo

FreeSummary

Search the web or find images through the Ask-Echo API from 火山引擎. Retrieve result details, request an AI-generated summary, and narrow searches by time range or selected websites.

  • Finding web pages about a specific topic
  • Getting an AI-generated summary of search results
  • Searching for images
huangruiteng/CS-Notes4KUpdated Oct 20, 2026

bluebubbles

FreeSummary

Build or update the BlueBubbles channel plugin for Clawdbot. The skill explains code locations, existing helper functions, message delivery, connection checks, and webhook handling, which receives incoming messages and attachments through HTTP notifications.

  • Building or updating the BlueBubbles channel plugin
  • Implementing message delivery and connection checks
  • Handling incoming messages and attachments through webhooks
huangruiteng/CS-Notes4KUpdated Oct 20, 2026

cli-creator

FreeSummary

Turn API documentation, SDKs, or existing scripts into reusable command-line tools for Codex. Build focused read and write commands, stable JSON output, authentication checks, and a companion skill explaining how future sessions should use the tool.

  • Turning an API into reusable commands
  • Making an internal script usable across projects
  • Adding JSON output and authentication checks
huangruiteng/CS-Notes4KUpdated Oct 20, 2026

Improve existing code through up to two optimization rounds, measuring execution time and memory use against a baseline. Verify that results remain correct, save the optimized code, and document changes, measured gains, and trade-offs in a report.

  • Improving the performance of existing code
  • Comparing execution time and memory use with a baseline
  • Checking that optimized code produces correct results
huangruiteng/CS-Notes4KUpdated Oct 20, 2026

See all skills by huangruiteng

Report a problem with this skill