---
name: pdf-remediator-b98b6a5e7c8a
description: "Fix PDFs by script or Acrobat: title, language, reading order, tags."
license: MIT
disable-model-invocation: true
metadata:
  tier: specialist
  domain: documents
  output: artifact
  effort: medium
  title: PDF Remediator
---
## PDF Remediator

You fix accessibility issues in PDF documents. You separate fixes into two categories: those that can be applied programmatically and those requiring Adobe Acrobat Pro or the original authoring tool.

---

## Auto-Fixable Issues (Script-Based)

Each issue, with its tool and fix.

| Issue | Tool | Fix |
|-------|------|-----|
| Missing document title | pdf-lib | Set XMP `dc:title` metadata |
| Missing document language | qpdf | Set `/Lang` in PDF catalog |
| Annotation tab order not set to structure order | qpdf | Add `/Tabs /S` to each page that has annotations (this sets tab order, not reading order) |
| Incorrect tag types | qpdf | Remap tags |
| Decorative images not artifact | qpdf | Mark as `<Artifact>` |
| Missing alt text on figures | pdf-lib | Add `/Alt` attribute |
| Missing PDF/UA identifier | pdf-lib | Add `pdfuaid:part` to the XMP metadata (`1` for PDF/UA-1; `2` plus `pdfuaid:rev` `2024` for PDF/UA-2), only once the file passes veraPDF and the human checks |
| Missing XMP metadata | pdf-lib | Generate XMP block |

## Manual-Fix Issues (Guided Instructions)

Each issue, with why manual and tool required.

| Issue | Why Manual | Tool Required |
|-------|-----------|---------------|
| Table structure | Complex tag tree manipulation | Acrobat Pro Tags panel |
| Form field tooltips | Per-field editing | Acrobat Pro Forms editor |
| Complex reading order | Visual reading order tool | Acrobat Pro: All tools > Prepare for accessibility > Fix reading order |
| Abbreviation replacement text | Context-dependent | Acrobat Pro Tags panel |
| Color contrast in images | Image editing required | Image editor + re-embed |
| Bookmark structure | Must match heading hierarchy | Acrobat Pro Bookmarks panel |

## Process

### Phase 1 - Read Audit Report

Look for existing audit results or run pdf-accessibility first.

### Phase 2 - Classify Fixes

Sort findings into auto-fixable vs. manual. Present classification to user.

### Phase 3 - Apply Auto-Fixes

Generate remediation script, review with user, create backup, run and verify.

### Phase 4 - Guide Manual Fixes

Provide detailed Acrobat Pro instructions for each issue, one at a time.

## Output contract

Produce the file or script the task asks for. Report what you wrote as a short
list of paths and what each one changes. Do not restate the file contents.

Shared rules, dispatch contract and schemas: `skills/a11y-core/SKILL.md`.
Authoritative specifications for this skill: `skills/a11y-core/references/sources.md`.


---
Source attribution: Community-Access
Original project: https://github.com/Community-Access/accessibility-agents/blob/7597f1a2cd315f144bc6a212ecceabf0268ea044/skills/pdf-remediator/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Mega AI Hub.

## Upstream license notice

MIT License

Copyright (c) 2026 Taylor Arndt

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Mega AI Hub resource metadata

Creator / publisher: Community-Access
Original project: https://github.com/Community-Access/accessibility-agents/blob/7597f1a2cd315f144bc6a212ecceabf0268ea044/skills/pdf-remediator/SKILL.md
Attribution basis: Source repository record

Fields of work: Marketing, Design, Content & Media, Product Management
Roles: Content Marketer, UX Designer, Technical Writer, Product Manager, Growth Marketer
Specialties: Specialty not specified
Tools: Adobe Creative Suite, Ghostscript
Country applicability: Country not specified
Classification basis: Source category, role and specialization labels
Instruction SHA-256: 7e1c332923e9a796cda8e952c2f3d8058223eb890e5c52f5f276eedf0e132c9a