neb-doc-maintenance

Detect documentation drift against git history and open a PR.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/nebinfra/nebcore-ai-skills --skill neb-doc-maintenance
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: neb-doc-maintenance
Source: https://github.com/nebinfra/nebcore-ai-skills/tree/main/neb-doc-maintenance
Command: npx skills add https://github.com/nebinfra/nebcore-ai-skills --skill neb-doc-maintenance

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audit top-level documentation (README, SPEC, PRODUCT) against recent git history to identify drift where features are missing from docs or upcoming features have landed. Proposes minimal edits, creates a branch, and opens a PR. Use when asked to review docs for accuracy, after major feature merges, or on a periodic schedule.

Core Features & Use Cases

  • Drift detection across README, SPEC, and PRODUCT by comparing against recent commits and shipped features.
  • Automated drift plan generation that surfaces exact edits and a PR-ready branch, with a minimal-change approach.
  • Governance-safe workflow that preserves voice and formatting while updating the central drift cursor for future reviews.

Quick Start

Trigger the doc-maintenance skill to detect drift, generate a drift summary, and open a PR with minimal edits.

Frequently Asked Questions about neb-doc-maintenance

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

FAQPage Schema
How do I detect documentation drift against recent git history?▼

Detect documentation drift by comparing top-level README, SPEC, and PRODUCT files against recent git commits. The process surfaces a concise drift report identifying where shipped features are missing from docs or upcoming features have already landed.

What is the best way to auto-suggest minimal edits for outdated documentation?▼

Auto-suggesting minimal edits for outdated documentation involves generating a targeted patch plan that preserves original voice and formatting. This approach aligns top-level docs with shipped features while keeping structural changes as small as possible.

How do I enforce a branch-and-PR workflow for documentation governance?▼

Enforce a branch-and-PR workflow for documentation governance by automatically creating a branch and opening a pull request with proposed edits. This ensures all documentation updates are reviewed before merging into the main repository.

When should I run a documentation audit for drift detection?▼

Run a documentation audit for drift detection after major feature merges or on a periodic schedule. This ensures top-level documents like README and SPEC remain accurate reflections of recently shipped code.

Does documentation drift detection preserve the existing formatting and voice?▼

Documentation drift detection preserves existing formatting and voice by enforcing a minimal-change approach. The generated patch plan updates content to align with shipped features without altering the original structural style.