Markdown Docs

Update Markdown documentation to match current codebase structure.

82|12|Updated Aug 31, 2025
One-click install
npx skills add https://github.com/PaulRBerg/dot-claude --skill markdown-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Markdown Docs
Source: https://github.com/PaulRBerg/dot-claude/tree/main/skills/md-docs
Command: npx skills add https://github.com/PaulRBerg/dot-claude --skill markdown-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates Markdown documentation tasks, keeping CLAUDE.md, AGENTS.md, and DOCS.md accurate and up-to-date with codebase changes.

Core Features & Use Cases

  • Context document maintenance: Verify and update CLAUDE.md, AGENTS.md, and optional DOCS.md against the codebase.
  • Backup and diff reporting: Create backups and show diffs before applying changes.
  • Documentation generation prompts: Produce targeted documentation content from codebase analysis.

Quick Start

Initialize or update context docs for a project by running the /md-docs workflows to align CLAUDE.md and related files with the current code structure.

Frequently Asked Questions about Markdown Docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep my Markdown documentation synchronized with code changes?

Markdown documentation automation reads your codebase structure and updates CLAUDE.md, AGENTS.md, and DOCS.md to reflect current code and API surfaces. Run the /md-docs workflow to align docs with actual repository contents, then review diffs before applying changes.

Can I preview documentation changes before applying them?

Yes. The workflow supports --dry-run mode to show proposed changes and diffs without modifying files, plus --preserve to keep existing content. Create backups automatically and review the concise change report before committing updates.

What's the best way to initialize documentation for a new project?

Run the /md-docs workflow on a fresh repository to initialize CLAUDE.md and AGENTS.md aligned with your codebase structure. The Skill analyzes repository contents and generates targeted documentation content from actual code and API surfaces.

Does this work with existing README and documentation files?

Yes. The workflow checks and updates target docs against codebase structure, supporting optional DOCS.md and existing README workflows. Use --thorough or --minimal modes to control update depth based on your documentation scope.

Why should I automate documentation maintenance instead of updating manually?

Manual updates drift from code as repositories evolve. Automation verifies docs against live codebase structure, detects misalignments, and applies terse expert-level edits—reducing documentation debt while keeping README and context files accurate.