community-access/accessibility-agents

pdf-remediator

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

Zobacz źródło

Jak używać

  1. Skopiuj polecenie instalacji i sprawdź źródła przed instalacją we własnym środowisku agenta.
  2. W oryginale sprawdź wymagane narzędzia, dane dostępowe i obsługiwane środowiska.
  3. Opisz dane wejściowe i oczekiwany rezultat; porównaj wynik ze źródłami.
npx skills add https://github.com/community-access/accessibility-agents --skill pdf-remediator

Przed rozpoczęciem

  • Instalacja nie obejmuje subskrypcji modelu, limitu API ani uprawnień do plików.
  • Gwiazdki i instalacje pokazują aktywność, a nie niezależny test jakości lub bezpieczeństwa.
Oryginalny dokument Skill

Treść z repozytorium z zachowaniem nagłówków, przykładów, kodu, tabel, linków i obrazów.

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.

z tego samego repozytorium

Więcej Skills

Wszystkie Skills