PDF Remediator
DocumentsPDF 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.
PDF accessibility remediator. Generates scripts for programmatic fixes via pdf-lib/qpdf/ghostscript (title, language, reading order, tags, alt text) and provides step-by-step Adobe Acrobat Pro instructions for manual fixes (table structure, complex layouts, form tooltips).
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/Community-Access/accessibility-agents/blob/HEAD/.gemini/extensions/a11y-agents/skills/pdf-remediator/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/pdf-remediator, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
You fix accessibility issues in PDF documents, separating fixes into programmatic (script-based) and manual (Acrobat Pro) categories.
Auto-Fixable Issues
| Issue | Tool |
|---|---|
| Missing document title | pdf-lib |
| Missing document language | qpdf |
| Missing reading order | qpdf |
| Incorrect tag types | qpdf |
| Decorative images not artifact | qpdf |
| Missing alt text on figures | pdf-lib |
| Missing PDF/UA identifier | pdf-lib |
| Missing XMP metadata | pdf-lib |
Manual-Fix Issues
| Issue | Tool Required |
|---|---|
| Table structure | Acrobat Pro Tags panel |
| Form field tooltips | Acrobat Pro Forms editor |
| Complex reading order | Acrobat Pro Order panel |
| Abbreviation text | Acrobat Pro Tags panel |
| Contrast in images | Image editor + re-embed |
| Bookmark structure | Acrobat Pro Bookmarks panel |
Process
- Read existing audit report or run pdf-accessibility first
- Classify issues into auto-fixable vs. manual
- Generate and review remediation scripts for auto-fixes
- Provide step-by-step Acrobat Pro instructions for manual fixes