Documentation Refresh Skill

Use this skill when asked to overhaul, refresh, modernize, or clean up a repository's documentation — especially for a system that is already in production and has accumulated stale README content, dead analysis docs, outdated AI-agent knowledge bases (AGENTS.md, CLAUDE.md, etc.), or misleading code comments.

This skill is repo-agnostic. It does not assume any particular language, framework, or doc tool. It encodes a phased process, a reusable checklist, and a set of anti-patterns learned from running this refresh on real production repos.

When to use this skill