# Summarize Markdown

> Reads markdown files in a project directory and produces a structured summary of their contents. Use when the user wants to summarize documentation, get an overview of markdown files, or understand a directory of docs.

- Skill: `bcbeidel/summarize-markdown` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add bcbeidel/summarize-markdown`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bcbeidel/summarize-markdown/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: bcbeidel (https://skillmd.com/u/bcbeidel)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/bcbeidel/summarize-markdown

---


# Summarize Markdown

Read markdown files in a specified directory and produce a structured
summary of their contents.

## Workflow

1. Accept a directory path from the user.
2. Use Glob to find all `*.md` files in the directory.
3. Use Read to read each file's contents.
4. For each file, extract:
   - The title (first `#` heading)
   - Any YAML frontmatter description
   - Key sections (second-level headings)
5. Present a summary table to the user:

| File | Title | Key Sections |
|------|-------|-------------|
| ... | ... | ... |

## Rules

- Only read files — never modify, create, or delete anything.
- Limit to the specified directory — do not traverse parent directories.
- If no markdown files are found, report that clearly.