maintain-docs

What problem does it solve?

This Skill eliminates the pain of outdated, inconsistent, or verbose documentation that doesn't reflect the current codebase. It ensures your documentation is always accurate, easy to retrieve, and free from temporal language, saving developers time and reducing confusion.

Core Features & Use Cases

• Automated Anchor Management: Use helper scripts to add and validate stable anchors, making documentation perfectly compatible with doc-lookup for precise retrieval.
• Temporal Language Removal: Automatically identifies and removes outdated phrases like "now supports" or "recently added," ensuring docs describe the current state, not historical changes.
• Content Consolidation: Merges duplicate information and enforces a single source of truth using intelligent cross-references, reducing redundancy and improving clarity.
• Use Case: After a major refactoring or feature release, run this skill to automatically audit and update all affected documentation. It will remove outdated information, add necessary anchors, and ensure every doc reflects the current implementation, so AI agents and humans alike always get accurate context.

Quick Start

Preview anchor additions (dry-run)

make docs-add-anchors-dry

Add anchors to features/formats/projects docs

make docs-add-anchors