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

Content Management

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

About

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.

Key Features

Support for multiple documentation formats including Markdown, MDX, and reStructuredText
Validation hooks to ensure documentation consistency before commits and PRs
Interactive configuration mode to auto-discover documentation structures and paths
0 GitHub stars
Deterministic generation of API and schema documentation from source files
Automatic updates for the skills table in CLAUDE.md project instructions

Use Cases

Syncing API documentation automatically after modifying backend source code or schemas
Validating that human-written guides remain consistent with the latest code changes during CI
Updating 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

Download Skill

GitHub