# Ooxml Validator

> Validate the XML inside a .docx or .xlsx against the OOXML schemas, and render an HTML report of the failures. Use when a generated Office document opens with a repair prompt or fails to open at all.

- Skill: `stbenjam/ooxml-validator` (Agent Skill, multi-file: 13 files)
- Install (CLI): `npx skillmds@latest add stbenjam/ooxml-validator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/stbenjam/ooxml-validator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: stbenjam (https://skillmd.com/u/stbenjam)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/stbenjam/ooxml-validator

---


# OOXML Validator

Unpack the document, then validate every part against the OOXML schemas:

```bash
unzip -q report.docx -d unpacked/
python scripts/validate.py unpacked/ --report validation.html
```

## Reading the output

Each failure names the part, the line, and the schema rule it violated.
Fix the part in `unpacked/`, re-zip, and re-run until the run is clean.

Pass `--strict` to fail on the warnings the Office applications tolerate,
such as an unknown attribute in a namespace the document declares but
never uses.

Legacy flat-file exports are out of scope: convert them to .docx first.