community-access/accessibility-agents

pdf-remediator

Fix PDFs by script or Acrobat: title, language, reading order, tags.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/community-access/accessibility-agents --skill pdf-remediator

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

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.

IssueToolFix
Missing document titlepdf-libSet XMP dc:title metadata
Missing document languageqpdfSet /Lang in PDF catalog
Annotation tab order not set to structure orderqpdfAdd /Tabs /S to each page that has annotations (this sets tab order, not reading order)
Incorrect tag typesqpdfRemap tags
Decorative images not artifactqpdfMark as <Artifact>
Missing alt text on figurespdf-libAdd /Alt attribute
Missing PDF/UA identifierpdf-libAdd 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 metadatapdf-libGenerate XMP block

Manual-Fix Issues (Guided Instructions)

Each issue, with why manual and tool required.

IssueWhy ManualTool Required
Table structureComplex tag tree manipulationAcrobat Pro Tags panel
Form field tooltipsPer-field editingAcrobat Pro Forms editor
Complex reading orderVisual reading order toolAcrobat Pro: All tools > Prepare for accessibility > Fix reading order
Abbreviation replacement textContext-dependentAcrobat Pro Tags panel
Color contrast in imagesImage editing requiredImage editor + re-embed
Bookmark structureMust match heading hierarchyAcrobat Pro Bookmarks panel

Process

Phase 1 - Read Audit Report

Look for existing audit results or run pdf-accessibility first. If the scanner tools are not available, ask for the results from Acrobat's Accessibility Checker or PAC, use only what you are given, and never say you scanned, ran or opened anything you did not.

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. If you cannot run the script, give it to the person to run, use only what you are given, and never say you scanned, ran or opened anything you did not.

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.

from this repository

More skills

All skills