doc-maintenance

Detect documentation drift in README.md, doc/SPEC.md, and doc/PRODUCT.md against recent git history.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Kauedz/althius-alg --skill doc-maintenance-kauedz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-maintenance
Source: https://github.com/Kauedz/althius-alg/tree/main/.agents/skills/doc-maintenance
Command: npx skills add https://github.com/Kauedz/althius-alg --skill doc-maintenance-kauedz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill detects drift between the current top-level documentation (README.md, doc/SPEC.md, and doc/PRODUCT.md) and recent git history, helping teams keep public docs accurate and aligned with shipped features.

Core Features & Use Cases

  • Detect documentation drift across README.md, doc/SPEC.md, and doc/PRODUCT.md.
  • Propose minimal, factual edits and create a branch and PR to fix drift.
  • Use after major feature merges or on a periodic schedule to maintain accurate documentation.

Quick Start

Audit repository documentation for drift and propose minimal edits by creating a branch and opening a PR.

Frequently Asked Questions about doc-maintenance

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

FAQPage Schema
How do I detect documentation drift between my README and recent git history?

Documentation drift is detected by comparing top-level docs like README.md and doc/SPEC.md against recent git history. This identifies missing or outdated content after feature merges, proposing minimal factual edits as PR-ready changes.

Can I automatically create a branch and PR to fix outdated documentation?

Yes, you can automatically fix outdated documentation by creating a branch and opening a PR. This workflow builds a change summary from detected drift and proposes minimal, factual edits directly to the repository.

What is the best way to audit repository documentation for accuracy after a major feature merge?

Auditing repository documentation for accuracy after a major merge involves comparing top-level docs against recent git history. This detects drift and proposes minimal, PR-ready edits to keep public docs aligned with shipped features.

When should I run a documentation audit to prevent content drift?

You should run a documentation audit to prevent content drift after major feature merges or on a periodic review schedule. This ensures top-level documentation remains accurate and aligned with shipped features over time.

Does this documentation drift detection work with specific files like SPEC.md and PRODUCT.md?

Yes, documentation drift detection works specifically with README.md, doc/SPEC.md, and doc/PRODUCT.md. It compares these top-level files against recent git history to identify missing or outdated content and propose minimal edits.