---
name: v8-doc-invalidation-checker
description: "Analyzes recent commits and uses a smart AI subagent to check if they invalidate any documentation in docs/."
license: "NOASSERTION"
metadata:
  decimalai-skill-id: "79e84d37-5ad6-44bc-a246-0f37c6a8d85e"
  decimalai-version-id: "fde02107-4285-4871-a96d-d4f9f66c7a7e"
  decimalai-version: "1"
  decimalai-body-sha256: "5f93a772a0c15777c65f381b312ecc6fb404b48f007c50fcd8d51dad672a3cc9"
  decimalai-name: "v8/doc-invalidation-checker"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "documentation"
  decimalai-source: "https://app.decimal.ai/s/v8-doc-invalidation-checker@1/SKILL.md"
---
# Documentation Invalidation Checker

Use this skill when you need to determine if recent commits invalidate
information within the documentation in the `docs/` directory.

## Steps to Perform Analysis

1. **Retrieve Recent Commits**: Execute the `get_recent_commits.py` script to
   fetch the recent commits with their diffs:

   ```bash
   agents/scripts/get_recent_commits.py 5
   ```

2. **Identify Relevant Documentation**: Look at the modified files and
   descriptions in the commit diff. Identify which files in `docs/` discuss the
   modified modules or concepts.

3. **Invoke the Subagent for AI Analysis**: Use the `invoke_subagent` tool to
   call a subagent with the `pro` model tier. Provide the subagent with:

   - The commit message and diff.
   - The content of the relevant file(s) from `docs/`.

4. **Subagent Analysis Prompt**: The subagent should receive a prompt like:

   > Compare this commit diff with the documentation file `[doc_path]`. Does
   > this commit make any statement, step, or configuration in the documentation
   > obsolete, incorrect, or deprecated? If yes, specify exactly what section is
   > invalidated and provide recommended text edits.

5. **Document and Present**: Collate the invalidation findings into a
   walkthrough report for update.

## Tools Used

- **[get_recent_commits.py](../../scripts/get_recent_commits.py)**: Retrieves
  recent commits and their diffs.