| name | report-qa-docx |
| description | Review DOCX reports for missing figures, stale wording, duplicate sections, caption drift, and local consistency issues. Use this skill when a user asks for a quality pass on a Word report, wants to compare exported versus source versions, or needs a review-driven cleanup checklist before delivery. |
| license | BSD-3-Clause (see repo LICENSE) |
Report QA DOCX
Overview
Use this skill for a pragmatic QA pass on report-style DOCX files.
Focus on structural defects, wording drift, and figure/caption consistency.
When to use
- Check whether figures are missing or orphaned
- Detect duplicated chapter blocks or export artefacts
- Review terminology consistency after edits
- Compare a reviewed/exported DOCX against a working chapter DOCX
Workflow
- Scan figure captions and nearby media.
- Check for stale duplicated sections or repeated chapter exports.
- Search for terminology drift and known banned/stale phrases.
- Compare reviewed/exported variants against the working source.
- Report concrete issues first; patch only what the user asks to change.
Quick start
python scripts/check_docx_report.py report.docx
python scripts/check_docx_report.py report.docx --term "Scope:" --term "TS1" --json
Output style
Always report:
- confirmed issues
- likely issues needing visual confirmation
- remaining non-blocking inconsistencies
References
- Read
references/checklist.md for the QA checklist.
- Use
scripts/check_docx_report.py for a deterministic first-pass report.
