skills.rest
julianjab
julianjabCOMMUNITY
Explore all skills by this author →
GitHub

sync-docs

Audit CLAUDE.md files and auto-align them with the current codebase.

Updated Apr 1, 2026
Search Tags:#automation#documentation#codebase#audit#claude.md#drift#docs-sync
One-click install
npx skills add https://github.com/julianjab/ia-tools --skill sync-docs-julianjab
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sync-docs
Source: https://github.com/julianjab/ia-tools/tree/main/skills/sync-docs
Command: npx skills add https://github.com/julianjab/ia-tools --skill sync-docs-julianjab

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drift between CLAUDE.md documentation and the actual codebase undermines trust and slows reviews. This Skill audits CLAUDE.md files across the repository and auto-updates them to reflect the current state.

Core Features & Use Cases

  • Drift detection: compares CLAUDE.md with the code to identify mismatches in services, components, and commands.
  • Auto-fix & patching: applies conservative updates to align docs with code, with a safe dry-run option.
  • Use Case: When preparing a PR, run sync-docs to ensure CLAUDE.md accurately documents the current project structure.

Quick Start

Run the sync-docs tool to audit and auto-update CLAUDE.md files across the repository.

Frequently Asked Questions about sync-docs

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

FAQPage Schema
How do I keep CLAUDE.md documentation aligned with my codebase?▼

To align CLAUDE.md with your codebase, audit the files against the current code to detect drift, then apply conservative auto-fixes. This ensures documentation accurately reflects services, components, and commands before you submit a pull request.

What is documentation drift in a monorepo and how do I detect it?▼

Documentation drift occurs when CLAUDE.md files become outdated relative to the actual code. You detect this drift by scanning root, core, app, and package-level CLAUDE.md files to identify mismatches in structure, dependencies, commands, and integration points.

Can I dry-run documentation updates before applying fixes to CLAUDE.md?▼

Yes, you can perform a dry-run to preview documentation updates before applying them. This safe option allows you to review suggested patches that align CLAUDE.md with the codebase without immediately modifying the actual files.

How do I auto-fix outdated CLAUDE.md files before creating a PR?▼

To auto-fix outdated CLAUDE.md files before a PR, run a documentation sync audit that applies conservative updates aligning docs with code. This ensures your project structure, components, and commands are accurately documented for code review.

Does CLAUDE.md synchronization work across multiple packages in a monorepo?▼

Yes, CLAUDE.md synchronization works across multiple packages in a monorepo. The audit scans root, core, app, and package-level files to detect structural drift and suggest fixes, ensuring every layer of the repository remains accurately documented.

What specific codebase structures are checked during a CLAUDE.md audit?▼

During a CLAUDE.md audit, the system runs structured checks for project structure, components, dependencies, commands, patterns, and integration points. This comprehensive comparison identifies exactly where the documentation has drifted from the actual code.

Related Skills

Explore More Software Engineering Skills→
PaulRBergPaulRBerg
82

Markdown Docs

Update Markdown documentation to match current codebase structure.

Community
Advanced
toinfinityaitoinfinityai

code-review

Automate pull request reviews with coordinated multi-agent analysis.

Official
Advanced
gkganesh12gkganesh12
1

gk-review

Audit source code against documentation and test suites for architectural drift.

Community
Advanced
youssefKadaouiAbbassiyoussefKadaouiAbbassi

doc-hygiene

Audit and clean up markdown files for brevity, clarity, and formatting.

Community
Intermediate