skills.rest
baldimir
baldimirCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

update-claude-md

Analyze staged changes and propose CLAUDE.md section updates.

Updated Mar 31, 2026
Search Tags:#git#workflow#documentation#validation#repository#claude-md#update-claude-md
One-click install
npx skills add https://github.com/baldimir/bob-skills --skill update-claude-md-baldimir
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: update-claude-md
Source: https://github.com/baldimir/bob-skills/tree/main/.bob/skills/update-claude-md
Command: npx skills add https://github.com/baldimir/bob-skills --skill update-claude-md-baldimir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

CLAUDE.md is the central guidance document for repository workflows; this skill ensures CLAUDE.md stays accurate when workflows, conventions, or repository structure change, by proposing targeted updates based on staged changes.

Core Features & Use Cases

  • Detects staged changes that affect CLAUDE.md and maps them to relevant sections (Build Commands, Testing, CI/CD, Development Tools, and Repository Structure).
  • Proposes precise, before/after updates for the primary CLAUDE.md and modular linked files, then validates integrity.
  • Reverts changes if validation detects corruption and provides a testable workflow for audit.

Quick Start

Stage changes and run the update-claude-md skill to sync CLAUDE.md with 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, stage your modifications and run the skill to analyze the current document against staged changes, proposing targeted updates for alignment.

What is the best way to update CLAUDE.md after changing build commands or testing setup?▼

Updating CLAUDE.md after changing build commands or testing setup is best handled by mapping staged changes to relevant document sections like Build Commands, Testing, CI/CD, and Development Tools, then validating the result.

Can I use this skill with modular CLAUDE.md structures?▼

Yes, you can use this skill with modular CLAUDE.md structures. It proposes precise before/after updates for the primary document and linked files, validating integrity and reverting changes if corruption is detected.

Does update-claude-md preserve my configured project type when proposing edits?▼

Yes, update-claude-md preserves your user-configured project type. It analyzes staged changes and the current document to ensure alignment with repository workflows without overriding your existing project configuration.

What happens if validation detects corruption in CLAUDE.md updates?▼

If validation detects corruption in CLAUDE.md updates, the skill reverts the proposed changes automatically and provides a testable workflow for audit to ensure your repository documentation remains intact.

When do I need to update CLAUDE.md documentation for my repository?▼

You need to update CLAUDE.md documentation when workflows, conventions, or repository structure change. This skill ensures the document stays accurate by proposing targeted updates based on your staged git changes.

Related Skills

Explore More Software Engineering Skills→
kv0906kv0906
134

push

Stage all changes, generate commit messages, and push to the remote repository.

Community
Intermediate
ionfuryionfury
24

sync-claude

Validate and synchronize CLAUDE.md and SKILL.md documentation before commits.

Community
Advanced
ddttomddttom
2

pre-push-validation

Validate CLAUDE.md, README.md, and CHANGELOG.md updates before git push.

Community
Basic
Jesse-L-MJesse-L-M

document-release

Scan diffs and update README, ARCHITECTURE, CONTRIBUTING, CLAUDE.md, and CHANGELOG after releases.

Community
Advanced