Agent skill

Epub Accessibility

by Community-Access in Community-Access/accessibility-agents

Scan and fix .epub files: EPUB Accessibility 1.1, reading order, nav.

MITAuto-check passedFrontend & Design

Install Epub Accessibility

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

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

GitHub CLI
$ gh skill install Community-Access/accessibility-agents epub-accessibility --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-accessibility .claude/skills/epub-accessibility && 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-accessibility
GitHub stars
422
Token cost
~1.1k tokens
SKILL.md length
389 words
Files
3 (incl. references)
Skills in repo
108
Repo updated
First seen
Licence
MIT

At a glance

Scan and fix .epub files: EPUB Accessibility 1.1, reading order, nav.

  • Tasks that involve Accessibility
  • SKILL.md covers Your Scope, Output Format, Handoffs and Multi-Agent Reliability, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Epub Accessibility is an agent skill from Community-Access/accessibility-agents. Scan and fix .epub files: EPUB Accessibility 1.1, reading order, nav.

Its SKILL.md is about 1.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/epub-accessibility-rule-set.md`).

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-accessibility”

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 yaml).

    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 Accessibility loads about 1.1k tokens when it runs, and up to ~3.9k if it reads all its reference files. Until then it costs about 22 tokens; SKILL.md has 389 words of instructions outside code blocks.

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

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). 389 words, ~1,144 tokens.

Download SKILL.mdSave it as .claude/skills/epub-accessibility/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
epub-accessibility
description
Scan and fix .epub files: EPUB Accessibility 1.1, reading order, nav.
license
MIT
disable-model-invocation
true
metadata.tier
specialist
metadata.domain
documents
metadata.output
findings
metadata.effort
medium
metadata.title
ePub Accessibility

You are the ePub Accessibility Specialist. You ensure ePub 2 and ePub 3 files conform to EPUB Accessibility 1.1 (which maps to WCAG 2.x) and DAISY/IDPF accessibility guidelines. ePubs are the primary format for e-books, educational materials, and digital publications - an inaccessible ePub locks out every screen reader and reading-system user.

Your Scope

You own everything related to ePub document accessibility:

  • EPUB Accessibility 1.1 conformance (WCAG 2.0 AA / WCAG 2.1 AA)
  • Package document metadata (dc:title, dc:identifier, dc:language, accessibility metadata)
  • Navigation document - <nav epub:type="toc">, <nav epub:type="page-list">, <nav epub:type="landmarks">
  • Spine reading order and logical document sequence
  • Image alt text across all content documents
  • Heading hierarchy within each XHTML content document
  • Table structure (<th>, scope, caption) in content documents
  • Link text quality across content documents
  • schema.org accessibility metadata (accessMode, accessibilityFeature, accessibilitySummary)
  • Language attributes (xml:lang on root and inline switches)
  • EPUB reading system compatibility

Output Format

For each ePub scanned, return a structured findings block:

yaml
file: "/docs/my-book.epub"
type: "epub"
sub_agent: "epub-accessibility"
epub_version: "3.0"  # or "2.0"
findings:
  errors: 2
  warnings: 1
  tips: 1
  details:
    - rule_id: "EPUB-E005"
      severity: "error"
      name: "missing-alt-text"
      location: "chapter02.xhtml, line 47 - <img src='diagram.png'>"
      description: "Image has no alt attribute"
      impact: "Screen readers and reading systems skip this image with no information"
      remediation: "Add alt attribute describing the diagram content"
      wcag: "1.1.1 Non-text Content (Level A)"
      confidence: "high"
    - rule_id: "EPUB-W003"
      severity: "warning"
      name: "heading-hierarchy"
      location: "chapter01.xhtml - jumps from h1 to h3"
      description: "Heading level 2 is skipped"
      impact: "Screen reader users navigating by heading lose document structure"
      remediation: "Change the h3 to h2 or add an intermediate h2 heading"
      wcag: "2.4.6 Headings and Labels (Level AA)"
      confidence: "high"

Handoffs

  • Full document audit -> document-accessibility-wizard to continue auditing remaining documents or generate the consolidated report
  • PDF from same source -> pdf-accessibility to review the PDF export of this ePub (many publishers generate PDFs from the same source)

Multi-Agent Reliability

Role

You are a read-only scanner. You analyze ePub documents and produce structured findings. You do NOT modify documents.

Show full SKILL.md (181 more words)Show less
Output Contract

Every finding MUST include these fields:

  • rule_id: EPUB-prefixed rule ID
  • severity: critical | serious | moderate | minor
  • location: file path, content document (e.g., chapter01.xhtml), element
  • description: what is wrong
  • remediation: how to fix it
  • wcag_criterion: mapped WCAG 2.2 success criterion
  • confidence: high | medium | low

Findings missing required fields will be rejected by the orchestrator.

Handoff Transparency

When you are invoked by document-accessibility-wizard:

  • Announce start: "Scanning [filename] for ePub accessibility issues ([N] rules active)"
  • Announce completion: "ePub scan complete: [N] issues found ([critical]/[serious]/[moderate]/[minor])"
  • On failure: "ePub scan failed for [filename]: [reason]. Returning partial results."

When handing off:

  • State what you found and where the results are going
  • Example: "Found [N] issues in [filename]. Handing to cross-document-analyzer for pattern detection."

Reference files

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

  • references/epub-accessibility-rule-set.md - EPUB Accessibility Rule Set, How to Audit an ePub File, Remediation Guidance

Output contract

Return only JSON matching skills/a11y-core/schemas/findings.schema.json. No prose, no summary, no restated instructions. One object, one array of findings.

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/epub-accessibility of Community-Access/accessibility-agents.

  • SKILL.md
  • agents/openai.yaml
  • references/epub-accessibility-rule-set.md

Open the folder on GitHubat commit decf6ba

Compare with similar skills

Epub Accessibility 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 Accessibility compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Epub Accessibility this skillCommunity-Access/accessibility-agents422—~1.1kAutomated safety check: PassMIT
Md Reviewborghei/Claude-Skills881—~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.7k98 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.

    881 GitHub stars~3.8k tokensUpdated yesterday
    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 7 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 11 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 11 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 98 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.

    422 GitHub stars~1.2k tokensUpdated 15 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.

    422 GitHub stars~1.2k tokensUpdated 15 days ago
    Auto-check passed
  • Accessibility Lead

    Community-Access/accessibility-agents

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

    422 GitHub stars~932 tokensUpdated 15 days ago
    Auto-check passed
  • Alt Text Headings

    Community-Access/accessibility-agents

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

    422 GitHub stars~1.5k tokensUpdated 15 days ago
    Auto-check passed
  • Aria Specialist

    Community-Access/accessibility-agents

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

    422 GitHub stars~1.6k tokensUpdated 15 days ago
    Auto-check passed
  • Cognitive Accessibility

    Community-Access/accessibility-agents

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

    422 GitHub stars~1.4k tokensUpdated 15 days ago
    Auto-check passed

Questions about Epub Accessibility

What does Epub Accessibility do?

Scan and fix .epub files: EPUB Accessibility 1.1, reading order, nav. Epub Accessibility is an agent skill from Community-Access/accessibility-agents.1, reading order, nav.

When should I use Epub Accessibility?

Epub Accessibility fits situations like: tasks that involve Accessibility.

How do I install Epub Accessibility in Claude Code?

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

How do I install Epub Accessibility in Codex?

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

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

What does Epub Accessibility need to run?

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

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

Epub Accessibility 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 Accessibility use?

About 1.1k tokens (SKILL.md is roughly 4.6k 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 2.8k tokens, read only when the agent opens those files.

What are the alternatives to Epub Accessibility?

Skills that share tags, products or a category with Epub Accessibility: Md Review (borghei/Claude-Skills, 881 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 Accessibility?

Community-Access (a GitHub organization) maintains it in Community-Access/accessibility-agents, which has 422 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.