skills.rest
bengous
bengousCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/bengous/claude-code-plugins --skill sync-claude-md
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
dudusoardudusoar

git-log

Generate Conventional Commits messages and update GIT_LOG.md documentation.

Community
Basic
sobhanashinesobhanashine
1

document-release

Update markdown documentation files after shipping new versions.

Community
Advanced
cpfcoachingcpfcoaching

git-workflow-and-versioning

Teach structured git workflows including trunk-based development and atomic commits.

Community
Intermediate
pradyumnasagarpradyumnasagar
6

roadmap-author

Guide authors through creating and validating ORS SKILL.md files.

Community
Intermediate