community-access/accessibility-agents

pdf-remediator

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

Quelltext ansehen

Verwendung

  1. Installationsbefehl kopieren und das Quellpaket vor der Installation in der eigenen Agentenumgebung prüfen.
  2. Benötigte Werkzeuge, Zugangsdaten und Hosts im Original prüfen.
  3. Eingabe und gewünschtes Ergebnis beschreiben und die Ausgabe mit den Quellen abgleichen.
npx skills add https://github.com/community-access/accessibility-agents --skill pdf-remediator

Vor dem Start

  • Die Installation umfasst weder Modellabo noch API-Kontingent oder Dateizugriffsrechte.
  • Sterne und Installationen zeigen Aktivität, keine unabhängige Qualitäts- oder Sicherheitsprüfung.
Originales Skill-Dokument

Aus dem Quell-Repository gerendert; Überschriften, Beispiele, Code, Tabellen, Links und Bilder bleiben erhalten.

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.

aus demselben Repository

Weitere Skills

Alle Skills