Documentation Update Skill

Overview

This skill provides a systematic workflow for updating and cleaning up project documentation files. While primarily designed for feature documentation in .ai/features/, it works with any markdown documentation in the project including README.md, PROGRESS_TRACKER.md, CLAUDE.md, or documentation within code modules.

The skill removes verbose implementation details, code snippets, outdated information, and redundant content while preserving essential architectural decisions and technical context needed for future development.

It is particularly valuable for maintaining a lean, focused documentation set that provides maximum value without information overload.

When to Use This Skill

Use this skill when the user requests documentation cleanup, updates, or organization for:

• Feature documentation in .ai/features/ (primary use case)
• Core documentation (README.md, PROGRESS_TRACKER.md, CLAUDE.md)
• Any markdown file in the project that needs cleanup
• Module or component documentation that has become outdated