mp-update-docs

Scan documentation inventory and update markdown files to match codebase changes.

1|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-update-docs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mp-update-docs
Source: https://github.com/MartinoPolo/mpx-claude-code/tree/main/skills/mp-update-docs
Command: npx skills add https://github.com/MartinoPolo/mpx-claude-code --skill mp-update-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents Claude Code customization docs from drifting out of sync with your actual project workflows, scripts, and instructions—so you don’t waste time correcting the AI after every change.

Core Features & Use Cases

  • Doc inventory and gap analysis: Scans instruction files and README (plus other root markdown docs) to detect outdated sections, missing patterns, and mismatches with recent changes.
  • Context-aware review: Pulls project signals like package.json, recent git activity, and recent Claude conversation history to identify what needs updating.
  • Guided or direct updates: Produces a per-file update plan and asks which changes to apply, then edits only documentation files and optionally commits.

Quick Start

Run /mp-update-docs to review your documentation inventory, identify mismatches and gaps, and apply the updates you approve.

Frequently Asked Questions about mp-update-docs

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

FAQPage Schema
How do I keep Claude Code documentation in sync with my codebase?

To keep Claude Code documentation in sync, you can scan your markdown inventory, analyze recent git diffs and project context, then apply targeted edits to instruction files and READMEs to eliminate documentation drift.

What is documentation drift and how do I fix it in instruction markdown files?

Documentation drift happens when instruction markdown files become outdated as scripts and conventions change. You fix it by scanning project context and recent git activity to propose targeted edits per file, updating only the documentation.

How to automatically update README files based on recent git activity?

You can automatically update README files by pulling recent git activity and project signals like package.json to identify mismatches, generating a per-file update plan, and applying the approved changes directly to the markdown files.

Can I use conversation history to identify missing patterns in project documentation?

Yes, recent Claude conversation history is analyzed alongside project files and git context to detect outdated sections, missing patterns, and mismatches, ensuring documentation reflects actual current workflows.

Does this documentation update workflow require manual review before committing?

It produces a per-file update plan and asks which changes to apply, ensuring manual review. After approval, it edits only documentation files and can optionally commit the synchronized result directly.

When should I not use automated synchronization for instruction docs?

You should avoid automated synchronization when you need to edit source code alongside documentation, as this workflow strictly edits only markdown files and does not modify scripts, tools, or other project conventions.