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

MITAuto-check passedFrontend & Design

Install Epub Scan Config

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

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

GitHub CLI
$ gh skill install Community-Access/accessibility-agents epub-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/epub-scan-config .claude/skills/epub-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
epub-scan-config
GitHub stars
423
Token cost
~899 tokens
SKILL.md length
292 words
Files
2
Skills in repo
108
Repo updated
First seen
Licence
MIT

At a glance

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

  • Works in 5 steps: Never modify files outside… → Always validate JSON before writing -… → Preserve unrecognised keys - if the… → …
  • Tasks that involve Accessibility
  • SKILL.md covers Configuration Schema, Profile Presets, Available Rules and Behavioural Rules, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

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

Its SKILL.md is about 900 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It sits in Frontend & Design, covering Accessibility. 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

Example prompts

  • “/epub-scan-config”

Workflow steps

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

  1. Never modify files outside .a11y-epub-config.json.
  2. Always validate JSON before writing - ensure the output is valid JSON with correct field types.
  3. Preserve unrecognised keys - if the config has additional custom keys, do not remove them.
  4. Confirm before writing - show the proposed config to the user and confirm before saving.
  5. Default to moderate profile when creating a new config file unless the user specifies otherwise.

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

Epub Scan Config loads about 899 tokens when it runs. Until then it costs about 20 tokens; SKILL.md has 292 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~20
When it runs · the whole SKILL.md, loaded when a task matches
~899

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). 292 words, ~899 tokens.

Download SKILL.mdSave it as .claude/skills/epub-scan-config/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
epub-scan-config
description
Internal helper: manage .a11y-epub-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
ePub Scan Config

You manage .a11y-epub-config.json - the scan configuration file for ePub accessibility audits run by the epub-accessibility agent. You are invoked internally by the document-accessibility-wizard when .epub files are in scope and no config file exists, or when the user wants to customise rule settings.

Configuration Schema

json
{
  "$schema": "https://raw.githubusercontent.com/Community-Access/accessibility-agents/main/schemas/epub-scan-config.schema.json",
  "version": "1.0",
  "description": "Profile description",
  "epub": {
    "enabled": true,
    "disabledRules": [],
    "severityFilter": ["error", "warning"]
  }
}
Fields

Each field, with its type and description.

FieldTypeDescription
epub.enabledbooleanEnable/disable ePub scanning entirely
epub.disabledRulesstring[]Rule IDs to skip (e.g., ["EPUB-T002", "EPUB-T003"])
epub.severityFilterstring[]Which severities to report: any combination of "error", "warning", "tip"
epub.maxFileSizenumberMaximum file size in bytes (default: 104857600 = 100 MB)

Profile Presets

Strict - all rules, all severities
json
{
  "epub": {
    "enabled": true,
    "disabledRules": [],
    "severityFilter": ["error", "warning", "tip"]
  }
}
json
{
  "epub": {
    "enabled": true,
    "disabledRules": [],
    "severityFilter": ["error", "warning"]
  }
}
Minimal - errors only
json
{
  "epub": {
    "enabled": true,
    "disabledRules": [],
    "severityFilter": ["error"]
  }
}

Available Rules

Each rule ID, with its name and default severity.

Rule IDNameDefault Severity
EPUB-E001missing-titleerror
EPUB-E002missing-unique-identifiererror
EPUB-E003missing-languageerror
EPUB-E004missing-nav-tocerror
EPUB-E005missing-alt-texterror
EPUB-E006unordered-spineerror
EPUB-E007missing-a11y-metadataerror
EPUB-W001missing-page-listwarning
EPUB-W002missing-landmarkswarning
EPUB-W003heading-hierarchywarning
EPUB-W004table-missing-headerswarning
EPUB-W005ambiguous-link-textwarning
EPUB-W006color-only-infowarning
EPUB-T001incomplete-a11y-summarytip
EPUB-T002missing-authortip
EPUB-T003missing-descriptiontip

Behavioural Rules

  1. Never modify files outside .a11y-epub-config.json.
  2. Always validate JSON before writing - ensure the output is valid JSON with correct field types.
  3. Preserve unrecognised keys - if the config has additional custom keys, do not remove them.
  4. Confirm before writing - show the proposed config to the user and confirm before saving.
  5. Default to moderate profile when creating a new config file unless the user specifies otherwise.

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 1 other file in skills/epub-scan-config of Community-Access/accessibility-agents.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit decf6ba

Compare with similar skills

Epub 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.

Epub Scan Config compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Epub Scan Config this skillCommunity-Access/accessibility-agents423—~899Automated safety check: PassMIT
Md Reviewborghei/Claude-Skills891—~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
Jep Submissionbrycewang-stanford/Awesome-Journal-Skills1.2k—~1.1kAutomated safety check: PassMIT
Web Interface Guidelines Reviewervercel-labs/openreview1.7k97 repos~308Automated safety check: PassNone

Similar skills

  • Md Review

    borghei/Claude-Skills

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

    891 GitHub stars~3.8k tokensUpdated 3 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 9 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 13 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 13 days ago
    Frontend & DesignAuto-check passed
  • Web Interface Guidelines Reviewer

    vercel-labs/openreview

    Official

    Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my…

    1.7k GitHub starsUsed in 97 repos~308 tokens
    Frontend & DesignAuto-check passed
  • Accessibility Review

    markmead/hyperui

    Run a WCAG 2.1 AA accessibility audit on a design or page. An agent skill from markmead/hyperui.

    12k GitHub starsUsed in 1 repo~1.1k tokens
    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 17 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 17 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 17 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 17 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 17 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 17 days ago
    Auto-check passed

Questions about Epub Scan Config

What does Epub Scan Config do?

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

When should I use Epub Scan Config?

Epub Scan Config fits situations like: tasks that involve Accessibility.

How do I install Epub Scan Config in Claude Code?

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

How do I install Epub Scan Config in Codex?

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

Can I use Epub 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 epub-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/epub-scan-config, .gemini/skills/epub-scan-config, .github/skills/epub-scan-config and .opencode/skills/epub-scan-config in your project.

What does Epub Scan Config need to run?

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

Does Epub 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 Epub 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 Epub Scan Config use?

Epub 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 Epub Scan Config use?

About 899 tokens (SKILL.md is roughly 3.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Epub Scan Config?

Skills that share tags, products or a category with Epub Scan Config: Md Review (borghei/Claude-Skills, 891 stars), Educational Presentation (guia-matthieu/clawfu-skills, 150 stars), Chi Camera Ready (brycewang-stanford/Awesome-Journal-Skills, 1.2k stars) and Jep Submission (brycewang-stanford/Awesome-Journal-Skills, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Epub 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.