hermes

Edit a document for accessibility

Edits a Word, Google Docs, PDF-bound or web document for accessible reading, covering heading structure, link text, plain language, tables, reading order and alt-text placeholders.

context

An accessible document can be navigated and understood by people who use screen readers, magnification, keyboard-only navigation or reading aids, and by readers with cognitive or language differences. Most failures are editorial, which is why an editor can fix them: bold text pretending to be headings, skipped heading levels, "click here" links, tables used for layout or with merged cells, meaning carried only by colour or position ("the items in red", "see the box on the right"), images with no text alternative, and dense prose. Some fixes can only be made in the app: applying real heading styles, marking table header rows, setting the document title and language, and checking reading order in a tagged PDF. The relevant standard is WCAG 2.2, which most public-sector accessibility rules reference.

task

Edit this document for accessibility, for Only if [AUDIENCE_NEEDS] is given: , with these reader needs in mind: .

document

  1. If the document is empty, ask for it and stop.
  2. Structure: identify the title and the real sections. Mark headings as levels (# for the title, ## for sections, ### for subsections) with no skipped levels and one title. Turn fake headings (bold or capitals on their own line) into headings. Turn manual lists (lines starting with dashes or numbers typed by hand) into real lists.
  3. Links: rewrite link text so it makes sense out of context ("Download the 2026 fee schedule (PDF, 2 MB)" rather than "click here" or a bare URL). Keep the URL. Note file type and size if given.
  4. Images and non-text content: at each image, insert an [ALT: …] placeholder that says what the alt text must convey for its purpose in this document (for a chart, the key finding and where the data lives; for a decorative image, [ALT: decorative, mark as decorative]). Do not describe what you cannot see; base it only on the document's description and surrounding text.
  5. Tables: keep tables for data only. Give each a short caption or introductory sentence, a single header row, and no merged or empty cells; if a table is used for layout, turn it into headings and paragraphs.
  6. Sensory and colour-only meaning: rewrite instructions that depend on colour, shape or position so they also work in words ("items marked 'Overdue'" instead of "items in red").
  7. Plain language: shorten sentences over about 25 words, expand abbreviations at first use, replace jargon where a common word works, and avoid long passages in capitals or italics. Do not change the meaning, legal wording or required terms.
  8. Reading order: if the document mentions columns, text boxes, sidebars or floating elements, put the content in a logical linear order and note what must be fixed in the app.
  9. List the checks that must be done in the app for : for Word, apply built-in heading styles, mark table header rows, add alt text, set the document title and language, and run Review > Check Accessibility; for Google Docs, use the Styles menu for headings and add alt text to each image; for PDF, author it accessibly first, export with document structure tags, then verify reading order and tags in an accessibility checker; for web, use semantic HTML headings, lists, table headers and alt attributes.
constraints
  • Preserve the content and meaning. Edits are structural and for clarity, not a rewrite of the author's argument.
  • Do not invent image content, data or link destinations; use placeholders.
  • Do not claim the document is "WCAG compliant". You can only fix what is in the text; say what still needs checking.
output format

Edited document

The edited document with heading levels marked, real lists, rewritten links, [ALT: …] placeholders and fixed tables.

Changes made

Bullets grouped by type: structure, links, images, tables, sensory language, plain language, reading order. Give before → after for links and sensory instructions.

Alt text to write

A table: Location | Purpose of the image | What the alt text should say, or "decorative".

Do in the app

A checklist of steps for that cannot be done in text.

Open questions

Anything the author must confirm, such as image content or link targets. "None" if none.

1 required value still a placeholder; the assistant will ask for it.

details

kind
Prompt: a task you run by name to get one finished thing back
domain
Writing and communication
category
Editing
level
Intermediate
made for
Writer / author, Technical writer, Teacher / tutor, Operations
risk
read-only
version
v1.0.0 · incubating
reviewed
2026-10-03
works in
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install edit-document-for-accessibility --target claude-code

This entry is in the full catalog, not the curated set the skills installer and plugins carry, so install it with the Hodios CLI.

pairs well with

All of Editing
PromptEditing

Format a document for scanning

Restructures a long unformatted document with headings, lists, tables and a summary line so it can be scanned, without changing the wording beyond joins and labels.

format-document-for-scanning
PromptEditing

Simplify a text to plain language

Rewrites a text in plain language at a target reading level while keeping every fact, obligation, right, deadline and condition intact, and shows a meaning check against the original.

simplify-to-plain-language
PromptEditing

Review a document for ambiguity

Finds statements in instructions, policies, requirements or agreements that readers could interpret two ways, explains each reading and its consequence, and proposes unambiguous wording.

review-document-for-ambiguity
PersonaEditing

Editor

Editor who serves the reader and the author's intent, edits at the right level with structure before lines, and explains every change so the author can accept, reject or learn from it.

editor
PromptEditing

Proofread a text

Corrects grammar, spelling, punctuation and consistency errors in the chosen English variety, preserving the author's voice, and lists each change with the rule behind it.

proofread-text
PromptEditing

Rewrite a text for tone

Rewrites a text in a target tone or register, such as warmer, firmer or more formal, without changing its facts, asks or commitments, and shows which tone dials moved.

rewrite-for-tone