sync-claude-md

Synchronize outdated CLAUDE.md files with codebase changes via git history analysis.

3|Updated Oct 9, 2025

Search Tags:#automation #git #documentation #claude #best-practices #CLAUDE.md

Ready to run

npx skills add https://github.com/bengous/claude-code-plugins --skill sync-claude-md

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: sync-claude-md
Source: https://github.com/bengous/claude-code-plugins/tree/main/claude-meta-tools/skills/sync-claude-md
Command: npx skills add https://github.com/bengous/claude-code-plugins --skill sync-claude-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps maintain CLAUDE.md up-to-date by analyzing git history, comparing against Anthropic best practices using parallel agents, and proposing comprehensive updates with user approval. It can also create CLAUDE.md if it doesn't exist.

Core Features & Use Cases

Version-aware updates: Analyzes commits since last CLAUDE.md update to surface changes.
Parallel agent reviews: Spawns three agents to assess alignment with official docs.
Proposal-driven changes: Generates a comprehensive update proposal for user approval.
New CLAUDE.md creation: If CLAUDE.md doesn't exist, creates one following best practices.

Quick Start

Invoke the skill to scan for CLAUDE.md, trigger parallel reviews, and present a change proposal for your review. Approve to apply the updates.

Frequently Asked Questions about sync-claude-md

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

FAQPage Schema

How do I keep CLAUDE.md synchronized with git history changes?▼

Synchronize CLAUDE.md by analyzing commits since the last update using git log and show commands, then applying a comprehensive change proposal that parallel review agents validate against Anthropic best practices before you approve and apply the updates.

What happens if CLAUDE.md is missing or outdated in my codebase?▼

The skill detects missing or outdated CLAUDE.md files, orchestrates three parallel agent reviews to assess alignment with official guidance, and generates a detailed Markdown proposal for your approval before creating or updating the file.

Can I use this to create a new CLAUDE.md from scratch?▼

Yes, the skill creates CLAUDE.md from scratch by scanning your codebase and git history, running parallel reviews against Anthropic best practices, and proposing a complete file following documentation standards for your approval.

How does the skill handle major architectural changes in my codebase?▼

The skill parses git history to detect major changes, spawns three parallel agents to review alignment with best practices, and proposes comprehensive updates that reflect architectural shifts before requiring your explicit approval.

Do I have control over what changes are applied to CLAUDE.md?▼

Yes, all updates are generated as a comprehensive Markdown proposal that you review and must explicitly approve before any changes are applied to your CLAUDE.md file.