review-docs-drift

Compare pull request code changes against repository documentation maps to report drift.

42|32|Updated May 7, 2026
One-click install
npx skills add https://github.com/gke-labs/kube-agents --skill review-docs-drift
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-docs-drift
Source: https://github.com/gke-labs/kube-agents/tree/main/.agents/skills/review-docs-drift
Command: npx skills add https://github.com/gke-labs/kube-agents --skill review-docs-drift

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents documentation rot by identifying discrepancies between source code changes and the repository's documentation, ensuring that technical claims, identifiers, and architectural descriptions remain truthful after every pull request.

Core Features & Use Cases

  • Drift Detection: Automatically flags when code changes invalidate documentation claims, such as file paths, default values, or agent topology.
  • Compliance Auditing: Verifies that documentation follows strict rules like canonical home ownership and generated region integrity.
  • Use Case: When a developer updates a service account name in the infrastructure code, this Skill identifies every document that references the old name and flags them for updates to prevent user confusion.

Quick Start

Use the review-docs-drift skill to analyze the current pull request and report all documentation inconsistencies against the main branch.

Frequently Asked Questions about review-docs-drift

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

FAQPage Schema
How do I detect documentation drift in pull requests?

You can prevent documentation rot by automatically analyzing pull request diffs to identify code changes that invalidate technical claims, file paths, default values, or architectural descriptions in the repository documentation.

What is the best way to automate documentation compliance auditing?

Automate compliance auditing by verifying repository documentation against strict canonical rules, checking for canonical home ownership and generated region integrity to ensure technical claims remain truthful after code modifications.

Do I need git access to check for documentation inconsistencies?

Yes, you need git access to check for documentation inconsistencies, as the analysis operates on pull request diffs and requires adherence to the repository's defined documentation structure and identifier-sources table.

How do I update technical writing when infrastructure code changes?

When infrastructure code changes, the Skill identifies every document referencing outdated identifiers like service account names and flags them for updates, preventing user confusion and maintaining documentation accuracy across the repository.

When should I not use automated drift detection for documentation?

Automated drift detection is not suitable when a repository lacks a defined documentation structure or identifier-sources table, as the validation logic depends on these canonical rules to map code changes to technical assertions.