How does pop-doc-sync identify sections to update?

It identifies specific markers in your markdown files, specifically HTML comment tags such as , to target only automated content.

Can this be used in CI/CD pipelines?

Absolutely. With the '--json' flag and specific exit codes, you can integrate this skill into your pipeline to fail builds if documentation is out of sync with the code.

Does it overwrite my manual documentation?

No, it is designed to only modify content within the designated AUTO-GEN comment blocks, strictly preserving all manual descriptions and notes outside those blocks.

Can I preview changes before they are applied?

Yes, the skill defaults to '--check' mode, which reports exactly what would change and highlights diffs without modifying your files.

Documentation Sync

Name: Documentation Sync
Author: jrc1883

byjrc1883

•

Learning & Documentation

Automatically synchronizes codebase architecture and metadata with project documentation to prevent documentation drift.

Documentation Sync (pop-doc-sync) is a specialized Claude Code skill designed to maintain high-fidelity documentation by programmatically updating AUTO-GEN sections in project files like CLAUDE.md. It analyzes the plugin structure, calculates agent and skill counts, maps directory trees, and identifies key configuration files, ensuring that developers and AI agents always have access to the most current state of the repository without the need for manual updates.

Key Features

01Automated AUTO-GEN section updates in CLAUDE.md

02Cross-reference validation and stale documentation detection

035 GitHub stars

04Dynamic generation of repository structure diagrams

05Tiered agent and skill count reporting

06JSON output support for CI/CD pipeline integration

Use Cases

01Standardizing repository structure visualization for new contributors

02Detecting documentation drift during the CI/CD release process

03Keeping CLAUDE.md up-to-date after adding new agents or skills

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jrc1883/popkit-claude pop-doc-sync

For use in Claude.ai and ChatGPT

Download Skill