How does it distinguish between README.md and CLAUDE.md?

It treats README.md as a human-centric guide for setup and usage, while CLAUDE.md is treated as a minimal, imperative set of instructions for AI agents.

Does this skill automatically commit changes to Git?

No, the skill is designed to update the files directly on your disk but will not commit or push changes unless you specifically instruct Claude to do so.

How does it verify if documentation is accurate?

The skill uses glob and grep to spot-check claims made in your docs—such as file paths, plugin names, and commands—against the actual state of the repository.

Can it handle nested project documentation?

Yes, the skill scans for markdown files at all directory levels and updates them based on the context of their specific sub-directory.

Does it include test coverage or line counts?

No, the skill intentionally avoids volatile metrics that change frequently to prevent documentation from becoming stale quickly.

Documentation Sync & Maintenance

Name: Documentation Sync & Maintenance
Author: lucaspimentel

bylucaspimentel

0•

Content Management

Synchronizes project documentation with the current codebase state to ensure READMEs and AI instructions remain accurate and relevant.

This skill automates the maintenance of project documentation by verifying existing claims against the actual codebase using glob and grep searches. It intelligently manages the distinction between human-centric documentation (README.md) and agent-centric instructions (CLAUDE.md), updating both simultaneously to reflect changes in file paths, commands, and features. By focusing on non-volatile information and skipping transient metrics, it ensures that documentation remains a reliable source of truth for both developers and AI assistants without requiring manual intervention.

Key Features

01Automated verification of documentation claims against the live codebase.

02Direct implementation of fixes to minimize workflow friction.

030 GitHub stars

04Recursive scanning for documentation across root and nested subdirectories.

05Dual-mode updates for human-focused READMEs and agent-focused CLAUDE.md files.

06Intelligent filtering to exclude volatile metrics like test coverage and line counts.

Use Cases

01Ensuring AI agent instructions in CLAUDE.md are synced with current project conventions.

02Refreshing documentation after a significant refactor or feature addition.

03Identifying and fixing stale file paths or shell commands in README files.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add lucaspimentel/claude-plugins update-docs

For use in Claude.ai and ChatGPT

Key Features

01Automated verification of documentation claims against the live codebase.

02Direct implementation of fixes to minimize workflow friction.

030 GitHub stars

04Recursive scanning for documentation across root and nested subdirectories.

05Dual-mode updates for human-focused READMEs and agent-focused CLAUDE.md files.

06Intelligent filtering to exclude volatile metrics like test coverage and line counts.

Use Cases

01Ensuring AI agent instructions in CLAUDE.md are synced with current project conventions.

02Refreshing documentation after a significant refactor or feature addition.

03Identifying and fixing stale file paths or shell commands in README files.