robertsolves

Improve Markdowns — Documentation skill for Claude Code

Documentation community

Rewrite the project's markdown files for clarity, fix stale references, remove tables, redistribute off-topic content, and keep CLAUDE.md / README.md lean.

How to install Improve Markdowns

Installs to ~/.claude/skills/robertsolves-agent-commands-improve-markdowns/SKILL.md

Terminal

mkdir -p ~/.claude/skills/robertsolves-agent-commands-improve-markdowns && curl -fsSL https://raw.githubusercontent.com/robertsolves/agent-commands/HEAD/commands/improve-markdowns.md -o ~/.claude/skills/robertsolves-agent-commands-improve-markdowns/SKILL.md

Restart Claude Code, or start a new session, for it to be picked up.

What Improve Markdowns does

description: Rewrite the project's markdown files for clarity, fix stale references, remove tables, redistribute off-topic content, and keep CLAUDE.md / README.md lean. Run when docs feel bloated, duplicated or stale, or after files, commands or packages were renamed or moved. Not for asking the owner product questions about a doc — use /interview-docs; not for syncing the core docs with the code — use /update-docs. argument-hint: "[paths] (default: every tracked .md file in the project)"

Alternatives in Documentation

Review Docs — Review and improve documentation (docstrings and comments) in a file 2.3k ★
Wiki Explore — Research and expand a wiki topic 411 ★
Wiki Export Marp — Generate a Marp slide deck from wiki content matching a topic 375 ★