Internal helper: manage .a11y-pdf-config.json scan settings.

MITAuto-check passedFrontend & Design

Install PDF Scan Config

skills CLI
$ npx skills add Community-Access/accessibility-agents --skill pdf-scan-config -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Community-Access/accessibility-agents pdf-scan-config --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Community-Access/accessibility-agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pdf-scan-config .claude/skills/pdf-scan-config && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pdf-scan-config
GitHub stars
423
Token cost
~1k tokens
SKILL.md length
376 words
Files
3 (incl. references)
Skills in repo
108
Repo updated
First seen
Licence
MIT

At a glance

Internal helper: manage .a11y-pdf-config.json scan settings.

  • Works in 7 steps: Always explain the impact of disabling a… → Never disable all PDFUA error rules -… → Recommend strict for any public-facing… → …
  • Tasks that involve Accessibility
  • SKILL.md covers Your Scope, Config File Format, Preset Profiles and Behavioral Rules, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

PDF Scan Config is an agent skill from Community-Access/accessibility-agents. Internal helper: manage .a11y-pdf-config.json scan settings.

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `agents/openai.yaml` and `references/complete-rule-reference.md`).

It sits in Frontend & Design, covering Accessibility and PDF. The repository describes itself as: Accessibility review agents for Claude Code, GitHub Copilot, and Claude Desktop. Eleven specialists that enforce WCAG 2.2 AA compliance so AI coding tools stop generating… The licence is MIT.

When your agent uses it

  • Tasks that involve Accessibility
  • Tasks that involve PDF

Example prompts

  • “/pdf-scan-config”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Always explain the impact of disabling a rule before doing it
  2. Never disable all PDFUA error rules - that defeats the purpose of scanning
  3. Recommend strict for any public-facing or government documents
  4. Warn when disabling PDFUA.01.001 or PDFUA.01.002 - these are the most fundamental checks
  5. When creating a new config, start with strict and let the user disable specific rules
  6. Validate that rule IDs in disabledRules are real rule IDs from the reference above
  7. Explain the difference between the three rule layers when users ask which rules to enable

What it can do on your machine

Read from SKILL.md and the folder at commit decf6ba. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

PDF Scan Config loads about 1k tokens when it runs, and up to ~2.1k if it reads all its reference files. Until then it costs about 19 tokens; SKILL.md has 376 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~19
When it runs · the whole SKILL.md, loaded when a task matches
~1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Community-Access/accessibility-agents at commit decf6ba, republished under its MIT licence (© Community-Access). 376 words, ~1,019 tokens.

Download SKILL.mdSave it as .claude/skills/pdf-scan-config/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
pdf-scan-config
description
Internal helper: manage .a11y-pdf-config.json scan settings.
license
MIT
disable-model-invocation
true
user-invocable
false
metadata.tier
helper
metadata.domain
documents
metadata.output
artifact
metadata.effort
low
metadata.title
PDF Scan Config

You are the PDF accessibility scan configuration manager. You help users customize which accessibility rules are enforced when scanning PDF documents. You manage .a11y-pdf-config.json configuration files that the scan_pdf_document MCP tool reads at scan time.

Your Scope

  • Create new .a11y-pdf-config.json files with sensible defaults
  • Edit existing configs to enable/disable specific rules
  • Apply preset profiles (strict, moderate, minimal)
  • Explain what each rule checks and why it matters
  • Validate config files for correctness
  • Recommend the right profile for the user's context (government, internal, public web)

Config File Format

The .a11y-pdf-config.json file lives in a project directory. The scanner searches from the PDF's directory upward until it finds one.

json
{
  "enabled": true,
  "disabledRules": [],
  "severityFilter": ["error", "warning", "tip"],
  "maxFileSize": 104857600
}
Fields

Each field, with its type, default and description.

FieldTypeDefaultDescription
enabledbooleantrueMaster switch for PDF scanning
disabledRulesstring[][]Rule IDs to skip (e.g., ["PDFBP.NAV.BOOKMARKS_FOR_LONG_DOCS"])
severityFilterstring[]["error","warning","tip"]Which severities to report
maxFileSizenumber104857600Max file size in bytes (100MB default)

Preset Profiles

json
{
  "enabled": true,
  "disabledRules": [],
  "severityFilter": ["error", "warning", "tip"]
}

All rules active. All severities reported. Required for Section 508, EN 301 549, or any public-facing document.

json
{
  "enabled": true,
  "disabledRules": [
    "PDFQ.PIPE.SOURCE_REBUILD",
    "PDFQ.PIPE.VERAPDF_VALIDATE"
  ],
  "severityFilter": ["error", "warning"]
}

All conformance and best-practice rules active. Tips suppressed. Pipeline suggestions hidden.

minimal (for legacy document triage)
json
{
  "enabled": true,
  "disabledRules": [
    "PDFBP.META.TITLE_DISPLAY",
    "PDFBP.TEXT.ACTUAL_TEXT",
    "PDFBP.TEXT.UNICODE_MAP",
    "PDFBP.TEXT.EMBEDDED_FONTS",
    "PDFBP.STRUCT.READING_ORDER",
    "PDFBP.IMG.ALT_QUALITY",
    "PDFBP.IMG.DECORATIVE_ARTIFACT",
    "PDFBP.NAV.TOC_LINKED",
    "PDFBP.TAB.SCOPE_SET",
    "PDFBP.TAB.COMPLEX_HEADERS",
    "PDFBP.LINK.DESCRIPTIVE_TEXT",
    "PDFQ.PIPE.SOURCE_REBUILD",
    "PDFQ.PIPE.VERAPDF_VALIDATE"
  ],
  "severityFilter": ["error"]
}

Only critical conformance and structural rules. Useful for triaging large document libraries to find the worst offenders.

Show full SKILL.md (162 more words)Show less

Behavioral Rules

  1. Always explain the impact of disabling a rule before doing it
  2. Never disable all PDFUA error rules - that defeats the purpose of scanning
  3. Recommend strict for any public-facing or government documents
  4. Warn when disabling PDFUA.01.001 or PDFUA.01.002 - these are the most fundamental checks
  5. When creating a new config, start with strict and let the user disable specific rules
  6. Validate that rule IDs in disabledRules are real rule IDs from the reference above
  7. Explain the difference between the three rule layers when users ask which rules to enable

Reference files

Read one only when the task reaches it. Do not read them all up front.

  • references/complete-rule-reference.md - Complete Rule Reference

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.

© Community-Access, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/pdf-scan-config of Community-Access/accessibility-agents.

  • SKILL.md
  • agents/openai.yaml
  • references/complete-rule-reference.md

Open the folder on GitHubat commit decf6ba

Compare with similar skills

PDF Scan Config next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

PDF Scan Config compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PDF Scan Config this skillCommunity-Access/accessibility-agents423—~1kAutomated safety check: PassMIT
Accessible Document CreatorFerroxLabs/wayland608—~4.3kAutomated safety check: PassApache-2.0
Paper2htmlQuZhan51496/paper2anything469—~3.3kAutomated safety check: NotesApache-2.0
Md Reviewborghei/Claude-Skills886—~3.8kAutomated safety check: PassMIT
Educational Presentationguia-matthieu/clawfu-skills150—~4.3kAutomated safety check: PassMIT
Chi Camera Readybrycewang-stanford/Awesome-Journal-Skills1.2k—~1.5kAutomated safety check: PassMIT

Similar skills

  • Accessible Document Creator

    FerroxLabs/wayland

    Create accessible PDF, Word, PowerPoint, and email documents with proper structure, reading order, alternative text, and compliance with PDF/UA, WCAG, and Section 508 standards.

    608 GitHub stars~4.3k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Paper2html

    QuZhan51496/paper2anything

    Convert an academic paper PDF into a publish-ready, self-contained single-page project homepage (a self-contained index.html) — the kind of paper landing page researchers host on GitHub Pages.

    469 GitHub stars~3.3k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check: notes
  • Md Review

    borghei/Claude-Skills

    Pre-publication quality gate for authored Markdown — heading structure, on-disk link resolution, readability, accessibility, terminology.

    886 GitHub stars~3.8k tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Educational Presentation

    guia-matthieu/clawfu-skills

    Transform Claude into an expert in evidence-based educational presentation design.

    150 GitHub stars~4.3k tokensUpdated 8 days ago
    Frontend & DesignAuto-check passed
  • Chi Camera Ready

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when preparing an accepted ACM CHI paper for publication — the TAPS source upload, the PCS publication-ready package, mandatory accessibility work (alt text…

    1.2k GitHub stars~1.5k tokensUpdated 12 days ago
    Frontend & DesignAuto-check passed
  • Jep Submission

    brycewang-stanford/Awesome-Journal-Skills

    A skill your agent uses when running the final pre-submission preflight for a Journal of Economic Perspectives (JEP) proposal or manuscript — email-based submission, the accessibility bar, AEA front…

    1.2k GitHub stars~1.1k tokensUpdated 12 days ago
    Frontend & DesignAuto-check passed

More from Community-Access/accessibility-agents

All 108 skills in this repo
  • A11y Core

    Community-Access/accessibility-agents

    Shared contract for the Accessibility Agents skills - dispatch, findings schema, report rules.

    423 GitHub stars~1.2k tokensUpdated 16 days ago
    Auto-check passed
  • Kb Web Scanning

    Community-Access/accessibility-agents

    Reference data, not a reviewer. An agent skill from Community-Access/accessibility-agents.

    423 GitHub stars~1.2k tokensUpdated 16 days ago
    Auto-check passed
  • Accessibility Lead

    Community-Access/accessibility-agents

    Web UI accessibility lead. An agent skill from Community-Access/accessibility-agents.

    423 GitHub stars~932 tokensUpdated 16 days ago
    Auto-check passed
  • Alt Text Headings

    Community-Access/accessibility-agents

    Alt text, SVGs, figures, charts, heading order, page titles and landmarks.

    423 GitHub stars~1.5k tokensUpdated 16 days ago
    Auto-check passed
  • Aria Specialist

    Community-Access/accessibility-agents

    ARIA roles, states and properties for custom widgets and dynamic content.

    423 GitHub stars~1.6k tokensUpdated 16 days ago
    Auto-check passed
  • Cognitive Accessibility

    Community-Access/accessibility-agents

    Plain language, WCAG 2.2 cognitive criteria, COGA guidance and auth UX.

    423 GitHub stars~1.4k tokensUpdated 16 days ago
    Auto-check passed

Questions about PDF Scan Config

What does PDF Scan Config do?

Internal helper: manage .a11y-pdf-config.json scan settings. PDF Scan Config is an agent skill from Community-Access/accessibility-agents.json scan settings.

When should I use PDF Scan Config?

PDF Scan Config fits situations like: tasks that involve Accessibility; tasks that involve PDF.

How do I install PDF Scan Config in Claude Code?

Run `npx skills add Community-Access/accessibility-agents --skill pdf-scan-config -a claude-code`. Or copy the skill folder (skills/pdf-scan-config in Community-Access/accessibility-agents) into .claude/skills/pdf-scan-config in your project. Claude Code loads it when a task matches its description.

How do I install PDF Scan Config in Codex?

Run `npx skills add Community-Access/accessibility-agents --skill pdf-scan-config -a codex`. Or copy the skill folder (skills/pdf-scan-config in Community-Access/accessibility-agents) into .agents/skills/pdf-scan-config in your project. Codex loads it when a task matches its description.

Can I use PDF Scan Config in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Community-Access/accessibility-agents --skill pdf-scan-config -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pdf-scan-config, .gemini/skills/pdf-scan-config, .github/skills/pdf-scan-config and .opencode/skills/pdf-scan-config in your project.

What does PDF Scan Config need to run?

SKILL.md names no scripts, command-line tools or credentials: PDF Scan Config is instructions for the agent only.

Does PDF Scan Config access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is PDF Scan Config safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does PDF Scan Config use?

PDF Scan Config is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does PDF Scan Config use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.1k tokens, read only when the agent opens those files.

What are the alternatives to PDF Scan Config?

Skills that share tags, products or a category with PDF Scan Config: Accessible Document Creator (FerroxLabs/wayland, 608 stars), Paper2html (QuZhan51496/paper2anything, 469 stars), Md Review (borghei/Claude-Skills, 886 stars) and Educational Presentation (guia-matthieu/clawfu-skills, 150 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PDF Scan Config?

Community-Access (a GitHub organization) maintains it in Community-Access/accessibility-agents, which has 423 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on September 23, 2026.

Source: Community-Access/accessibility-agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.