docs-refresh

Detect documentation drift and regenerate docs when source files change.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/dohernandez/claude-skills --skill docs-refresh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-refresh
Source: https://github.com/dohernandez/claude-skills/tree/main/plugins/docs-refresh/skills/docs-refresh
Command: npx skills add https://github.com/dohernandez/claude-skills --skill docs-refresh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps generated documentation aligned with source files, auto-detecting structure and regenerating docs to prevent drift.

Core Features & Use Cases

  • Automatically detects documentation directories (docs, documentation, wiki) and formats (markdown, rst, mdx).
  • Regenerates API references, guides, and CLAUDE.md content when source files change to ensure accuracy.
  • Supports project-specific configuration via .claude/skills/docs-refresh.yaml to tailor outputs and triggers.

Quick Start

Run /docs-refresh configure to auto-detect project documentation settings.

Frequently Asked Questions about docs-refresh

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

FAQPage Schema
How do I keep generated documentation in sync with source files automatically?

To keep documentation in sync with source files, you can automate updates to detect document drift and regenerate docs when source files change. This ensures generated API references and guides stay aligned with the latest code.

What is documentation drift and how do I prevent it in my project?

Documentation drift happens when generated docs become outdated relative to source files. You prevent drift by automating documentation-sync workflows that detect source changes and regenerate the affected markdown, rst, or mdx files.

How do I configure per-project documentation sync settings?

You configure per-project documentation sync behavior by creating a .claude/skills/docs-refresh.yaml file. This configuration file tailors output formats and triggers, or you can run /docs-refresh configure to auto-detect settings.

Does documentation-sync automation work with markdown, rst, and mdx formats?

Yes, documentation-sync automation detects multiple documentation formats including markdown, rst, and mdx. It automatically discovers documentation directories like docs, documentation, or wiki and regenerates content accordingly.

Can I regenerate API references and guides when source code changes?

Yes, you can regenerate API references, guides, and CLAUDE.md content when source files change. The automation detects structural updates in the source and refreshes the generated documentation to maintain accuracy.

Do I need any external dependencies to automate documentation refresh workflows?

No external dependencies are required to automate documentation refresh workflows. The skill operates independently using its internal configuration file to discover directories, detect drift, and output generated and human-written docs.