community-access/accessibility-agents

pdf-remediator

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

Vedi sorgente

Come usare

  1. Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
  2. Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
  3. Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/community-access/accessibility-agents --skill pdf-remediator

Prima di iniziare

  • L’installazione non include abbonamenti, quote API o accesso ai file.
  • Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Documento Skill originale

Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.

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.

dallo stesso repository

Altri Skills

Tutti gli Skills