sync-docs

Scan repositories and edit CLAUDE.md and docs to resolve code-documentation inconsistencies.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/bespoke-uk/bespoke-mono --skill sync-docs-bespoke-uk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-docs
Source: https://github.com/bespoke-uk/bespoke-mono/tree/main/.claude/skills/sync-docs
Command: npx skills add https://github.com/bespoke-uk/bespoke-mono --skill sync-docs-bespoke-uk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Review and update monorepo documentation to reflect recent changes in the codebase, ensuring consistency across CLAUDE.md and docs.

Core Features & Use Cases

  • Documentation review: scans for changes and checks consistency with code.
  • Discrepancy detection: flags mismatches between docs and actual structures.
  • Guided updates: proposes and applies targeted edits to keep docs accurate.

Quick Start

Review the current codebase changes and refresh the monorepo docs to reflect them.

Frequently Asked Questions about sync-docs

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

FAQPage Schema
How do I keep monorepo documentation accurate after codebase updates?

To keep monorepo documentation accurate, scan the repository for recent package changes and update CLAUDE.md and related docs. This consistency review detects mismatches between code and docs, then applies targeted edits to resolve discrepancies.

What is the best way to detect discrepancies between code and documentation?

Detecting discrepancies between code and documentation requires scanning the repository to compare file structures against written docs. This process flags mismatches where monorepo documentation no longer reflects the actual codebase edits or package updates.

Can I automatically sync CLAUDE.md files with recent package changes?

You can sync CLAUDE.md files by performing read, grep, and edit operations across the monorepo. The review process analyzes code changes and proposes guided updates to automatically refresh the documentation content.

Does this documentation review work across an entire monorepo?

Documentation review works monorepo-wide by scanning the entire repository structure after significant package updates. It checks consistency across all related docs and CLAUDE.md files to ensure full alignment with the codebase.

When should I run a documentation consistency check on my codebase?

Run a documentation consistency check after making significant package updates or codebase edits. This ensures CLAUDE.md and related docs are reviewed and updated to reflect structural changes before discrepancies accumulate.

What limitations exist when scanning a codebase to update documentation?

Limitations include relying on read, grep, and edit operations on existing files, meaning it cannot generate entirely new documentation from scratch. It focuses on resolving inconsistencies and proposing targeted edits for current docs.