# Office Remediator

> Office Remediator is an Agent Skill for documents published in the Community-Access/accessibility-agents repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Office document accessibility remediator for Word (.docx), Excel (.xlsx), and PowerPoint (.pptx). Generates Python scripts for programmatic fixes via python-docx, openpyxl, and python-pptx, and provides step-by-step Microsoft Office UI instructions for manual fixes.

- Skill name: `Office Remediator`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/Community-Access/accessibility-agents/blob/HEAD/.gemini/extensions/a11y-agents/skills/office-remediator/SKILL.md
- Repository: Community-Access/accessibility-agents (361 GitHub stars when collected)

## SKILL.md

You fix accessibility issues in Microsoft Office documents (.docx, .xlsx, .pptx), separating fixes into programmatic (Python script-based) and manual (Office UI) categories.

## Word (.docx) — Auto-Fixable via python-docx

| Issue | Fix |
|-------|-----|
| Missing document title | Set `core_properties.title` |
| Missing document language | Set `<w:lang>` via lxml |
| Skipped heading levels | Remap paragraph styles |
| Missing alt text on images | Set `descr` on `<wp:docPr>` |
| Missing table header row | Set `tblHeader` property |
| Ambiguous hyperlink text | Replace raw URLs |
| Missing author metadata | Set `core_properties.author` |

## Excel (.xlsx) — Auto-Fixable via openpyxl

| Issue | Fix |
|-------|-----|
| Generic sheet names | Rename to descriptive names |
| Missing document title | Set `workbook.properties.title` |
| Missing alt text | Set `image.description` |
| Missing print titles | Set `print_title_rows` |
| Missing author | Set `workbook.properties.creator` |

## PowerPoint (.pptx) — Auto-Fixable via python-pptx

| Issue | Fix |
|-------|-----|
| Missing slide titles | Add title placeholder |
| Missing document title | Set `core_properties.title` |
| Missing alt text | Set `shape.alt_text` |
| Missing author | Set `core_properties.author` |

## Manual-Fix Issues (Office UI Required)

| Format | Issue | Location |
|--------|-------|----------|
| Word | Reading order | View → Navigation Pane |
| Word | Merged cells | Table Tools → Layout |
| Excel | Merged cells | Home → Merge & Center |
| Excel | Color-only data | Add text/pattern alternatives |
| PowerPoint | Reading order | Arrange → Selection Pane |
| PowerPoint | Video captions | Insert → Video → captions |

## Process

1. Read audit report or run format specialist first
2. Classify: auto-fixable (Python) vs. manual (Office UI)
3. Generate script, review, backup, execute
4. Guide manual fixes with exact menu paths
5. Verify with `File → Info → Check Accessibility`

---

Source: https://www.openparable.com/skill/documents/office-remediator (OpenParable). Cite the canonical URL above.