update-claude-md

Detect repository workflow changes and update CLAUDE.md sections.

1|5|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/mdproctor/claude-skills --skill update-claude-md-mdproctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-claude-md
Source: https://github.com/mdproctor/claude-skills/tree/main/update-claude-md
Command: npx skills add https://github.com/mdproctor/claude-skills --skill update-claude-md-mdproctor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Auto-invoked by git-commit and java-git-commit when CLAUDE.md exists and staged changes may affect documented workflows, build commands, testing patterns, naming conventions, or repository structure.

Core Features & Use Cases

  • Proposes and applies updates to CLAUDE.md sections (Build Commands, Testing, CI/CD, Development Tools) when changes to the repository occur.
  • Validates the document group after edits, ensuring link integrity and module references for modular CLAUDE.md structures.
  • Reverts changes if a validation discovers critical corruption and surfaces actionable feedback.

Quick Start

Run the /update-claude-md command to synchronize CLAUDE.md with the latest repository changes.

Frequently Asked Questions about update-claude-md

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

FAQPage Schema
How do I keep CLAUDE.md in sync with repository workflow changes?

To keep CLAUDE.md in sync with repository workflow changes, this automation detects staged git commits affecting documented build commands or testing patterns and proposes corresponding updates to the relevant sections.

How do I update modular CLAUDE.md files and linked module references?

Updating modular CLAUDE.md files triggers validation checks ensuring link integrity and module references remain correct across grouped structures, reverting automatically if critical corruption is detected.

Does this CLAUDE.md automation work with git commit workflows?

This CLAUDE.md automation works with git commit workflows by auto-invoking when staged changes may affect documented development tools, CI/CD patterns, or naming conventions in the repository.

When should I use automated documentation updates for CLAUDE.md?

Use automated documentation updates for CLAUDE.md when managing code or documentation repositories that rely on modular instruction files to guide development and require synchronized edits after structural changes.

What happens if CLAUDE.md validation discovers critical corruption after an update?

If CLAUDE.md validation discovers critical corruption after an update, the process reverts the applied changes and surfaces actionable feedback to resolve the documented workflow inconsistencies.