Can this skill handle human-written documentation?

Yes, it manages human-written docs by validating their consistency with the source of truth while enforcing a 'never edit generated docs' policy for auto-generated files.

Why should I use this before creating a Pull Request?

Using it ensures all generated documentation is updated to reflect your code changes, preventing documentation drift and passing CI synchronization checks.

How do I trigger a documentation update?

You can use the /docs-refresh command within Claude Code or run project-specific commands like 'task docs:refresh' to regenerate all files.

What files does this skill primarily manage?

It manages the project documentation directory (docs/, wiki/), README.md, CONTRIBUTING.md, and the CLAUDE.md instructions file.

Does it support formats other than Markdown?

Yes, it is compatible with Markdown (.md), MDX (.mdx), and reStructuredText (.rst) formats.

Documentation Sync & Refresh

Name: Documentation Sync & Refresh
Author: dohernandez

bydohernandez

0•

内容管理

Synchronizes project documentation, API references, and CLAUDE.md instructions with source code through deterministic generation.

Documentation Sync & Refresh is a specialized Claude Code skill designed to automate the maintenance of project documentation by ensuring it remains perfectly in sync with the source of truth. It manages the generation of API references, updates the skills table in CLAUDE.md, and validates human-written guides against current code states. By using deterministic generation patterns and configurable task hooks, it eliminates the drift between code and documentation, providing a reliable way to refresh docs before pull requests or as part of a continuous integration workflow.

主要功能

01Support for multiple documentation formats including Markdown, MDX, and reStructuredText

02Validation hooks to ensure documentation consistency before commits and PRs

03Interactive configuration mode to auto-discover documentation structures and paths

040 GitHub stars

05Deterministic generation of API and schema documentation from source files

06Automatic updates for the skills table in CLAUDE.md project instructions

使用场景

01Syncing API documentation automatically after modifying backend source code or schemas

02Validating that human-written guides remain consistent with the latest code changes during CI

03Updating the CLAUDE.md skills table when adding or removing capabilities from a project

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dohernandez/claude-skills docs-refresh

For use in Claude.ai and ChatGPT

主要功能

01Support for multiple documentation formats including Markdown, MDX, and reStructuredText

02Validation hooks to ensure documentation consistency before commits and PRs

03Interactive configuration mode to auto-discover documentation structures and paths

040 GitHub stars

05Deterministic generation of API and schema documentation from source files

06Automatic updates for the skills table in CLAUDE.md project instructions

使用场景

01Syncing API documentation automatically after modifying backend source code or schemas

02Validating that human-written guides remain consistent with the latest code changes during CI

03Updating the CLAUDE.md skills table when adding or removing capabilities from a project