---
name: "python-docx-track-changes-audit"
description: "Inspect, review, and manipulate Word revisions, track changes, and reviewer comments."
metadata:
  author: "python-openxml"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "audit track changes in docx"
  - "extract comments from word python"
  - "detect unaccepted revisions docx"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# python-docx Track Changes & Comments Audit

Parses OpenXML markup in .docx files using Python to detect insertions (<w:ins>), deletions (<w:del>), reviewer comments (<w:comment>), and author metadata for compliance auditing.

## When to Invoke
Invoke this skill whenever you need to:
- audit track changes in docx
- extract comments from word python
- detect unaccepted revisions docx

## Execution SOP & Rules
1. Inspect document.xml for <w:ins> and <w:del> tags to detect unaccepted revisions.
2. Parse word/comments.xml to extract comment text, comment author, and referenced paragraph IDs.
3. Warn users if a document intended for publication contains hidden track changes or comments.
4. Accept or reject revisions programmatically by updating OpenXML nodes.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.