community-access/accessibility-agents

pdf-remediator

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

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/community-access/accessibility-agents --skill pdf-remediator

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

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.

来自同一仓库

更多 Skills

全部 Skills