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.