Review the artefact against Microsoft's Accessibility Checker rules, report what
fails, and fix it on request. Use the rule names below verbatim. They are the
same ones the author sees when they run the checker themselves in Office, so the
findings are recognisable and searchable.
Instructions
Get the file. Supported: .pptx, .docx, .html, .md. If the user pasted
raw HTML or Markdown instead, save it to a file first.
Run the bundled checker when a Python environment is available, from the
skill's own root directory (the folder containing scripts/), so the
relative path resolves:
python scripts/a11y_check.py <file> --json
It needs python-pptx for .pptx and python-docx for .docx; HTML and
Markdown need nothing beyond the standard library. If the environment has
no Python, or the import fails: for HTML and Markdown, read the file
directly and check it against the rules below by hand. For .pptx and
.docx, that fallback doesn't really work, these are zipped Office XML,
not something to eyeball as text, so instead say plainly that the file
couldn't be checked, and ask the user to run Office's own Accessibility
Checker (File > Info > Check for Issues > Check Accessibility) and share
what it reports.
Add the judgement calls the script deliberately does not make:
- Alt text that exists but is useless.
"image1.png", "chart", or a
filename is a failure even though the attribute is populated. Read every
alt string and judge whether someone who cannot see the image learns the
same thing from it.
- Wrongly decorative. Anything marked decorative that actually carries
information is a failure the script cannot see.
- Reading order that is flagged but fine. The script compares screen-reader
order with visual top-left order; deliberate multi-column layouts trip it.
Confirm before reporting.
- Meaning carried by colour alone, such as red/green status dots or "the
items in orange," which no file-level check can detect.
- Captions and transcripts for embedded audio or video.
- Contrast the script skipped. It only compares explicit RGB values.
Theme colours, gradients, and picture fills come back unchecked. Report
them as unchecked, never as passing.
Report findings grouped by severity, worst first, one row each:
| Severity |
Rule |
Where |
Fix |
| Error |
All slides have titles |
Slide 4 |
Add a title in the title placeholder |
Open with a one-line count (3 errors, 5 warnings, 1 tip). If nothing fails,
say so and list what could not be checked mechanically.
Offer to apply the fixes. Apply directly: adding a missing slide title, adding
a table header row, rewriting vague link text, adding lang to <html>,
fixing heading-level jumps. Ask first before writing alt text for an image
whose content is uncertain, marking anything decorative, changing colours, or
restructuring merged tables, since each of those changes meaning or design.
Re-run the checker after fixing and report what is left.
The rules
Errors: content that is unusable for someone relying on assistive tech.
- All non-text content has alternative text (alt text)
- Tables specify column header information
- All slides have titles
- All sections have meaningful names (the bundled script doesn't check this;
ask the user or inspect the file's sections manually)
- Document access is not restricted (the bundled script doesn't check this;
verify manually whether the file has IRM/password protection applied)
Warnings: content that is hard to use.
- Sufficient contrast between text and background (WCAG AA: 4.5:1 normal text,
3:1 for text 18pt+ or bold 14pt+)
- Table has a simple structure
- The reading order of the objects on a slide presentation is logical
- Closed captions are included for inserted audio and video
- Hyperlink text is meaningful
Tips: content that could be easier to use.
- Slide titles in a deck are unique
- Documents use heading styles
- Document language is set
Guardrails
- Never invent alt text for an image whose content is unknown. Ask the user what
it shows, or describe only what surrounding text supports and say the
description needs confirming.
- Never mark an object decorative to clear a finding. Decorative means it carries
no information; use it only when that is true.
- Never edit visible wording, layout, or branding beyond what a fix requires.
- Never report an unchecked item as a pass.
- Do not claim WCAG or EN 301 549 conformance. This is a pass over known rules,
not a certification. A clean result means no detected issues.
Tone
Direct and specific. Name the rule, the location, and the concrete fix. No
lecturing about why accessibility matters; the user already asked.
1---2name: accessibility-pass3description: Use this skill whenever the user asks to check, review, or fix the accessibility of a PowerPoint deck, Word document, HTML page, or Markdown file, and before handing over any deck or document this agent just generated, so it does not ship with missing alt text, untitled slides, or unreadable colour contrast.4---56Review the artefact against Microsoft's Accessibility Checker rules, report what7fails, and fix it on request. Use the rule names below verbatim. They are the8same ones the author sees when they run the checker themselves in Office, so the9findings are recognisable and searchable.1011## Instructions12131. Get the file. Supported: `.pptx`, `.docx`, `.html`, `.md`. If the user pasted14 raw HTML or Markdown instead, save it to a file first.15162. Run the bundled checker when a Python environment is available, from the17 skill's own root directory (the folder containing `scripts/`), so the18 relative path resolves:1920 ```bash21 python scripts/a11y_check.py <file> --json22 ```2324 It needs `python-pptx` for `.pptx` and `python-docx` for `.docx`; HTML and25 Markdown need nothing beyond the standard library. If the environment has26 no Python, or the import fails: for HTML and Markdown, read the file27 directly and check it against the rules below by hand. For `.pptx` and28 `.docx`, that fallback doesn't really work, these are zipped Office XML,29 not something to eyeball as text, so instead say plainly that the file30 couldn't be checked, and ask the user to run Office's own Accessibility31 Checker (File > Info > Check for Issues > Check Accessibility) and share32 what it reports.33343. Add the judgement calls the script deliberately does not make:3536 - **Alt text that exists but is useless.** `"image1.png"`, `"chart"`, or a37 filename is a failure even though the attribute is populated. Read every38 alt string and judge whether someone who cannot see the image learns the39 same thing from it.40 - **Wrongly decorative.** Anything marked decorative that actually carries41 information is a failure the script cannot see.42 - **Reading order that is flagged but fine.** The script compares screen-reader43 order with visual top-left order; deliberate multi-column layouts trip it.44 Confirm before reporting.45 - **Meaning carried by colour alone**, such as red/green status dots or "the46 items in orange," which no file-level check can detect.47 - **Captions and transcripts** for embedded audio or video.48 - **Contrast the script skipped.** It only compares explicit RGB values.49 Theme colours, gradients, and picture fills come back unchecked. Report50 them as unchecked, never as passing.51524. Report findings grouped by severity, worst first, one row each:5354 | Severity | Rule | Where | Fix |55 | --- | --- | --- | --- |56 | Error | All slides have titles | Slide 4 | Add a title in the title placeholder |5758 Open with a one-line count (`3 errors, 5 warnings, 1 tip`). If nothing fails,59 say so and list what could not be checked mechanically.60615. Offer to apply the fixes. Apply directly: adding a missing slide title, adding62 a table header row, rewriting vague link text, adding `lang` to `<html>`,63 fixing heading-level jumps. Ask first before writing alt text for an image64 whose content is uncertain, marking anything decorative, changing colours, or65 restructuring merged tables, since each of those changes meaning or design.66676. Re-run the checker after fixing and report what is left.6869## The rules7071**Errors**: content that is unusable for someone relying on assistive tech.7273- All non-text content has alternative text (alt text)74- Tables specify column header information75- All slides have titles76- All sections have meaningful names *(the bundled script doesn't check this;77 ask the user or inspect the file's sections manually)*78- Document access is not restricted *(the bundled script doesn't check this;79 verify manually whether the file has IRM/password protection applied)*8081**Warnings**: content that is hard to use.8283- Sufficient contrast between text and background (WCAG AA: 4.5:1 normal text,84 3:1 for text 18pt+ or bold 14pt+)85- Table has a simple structure86- The reading order of the objects on a slide presentation is logical87- Closed captions are included for inserted audio and video88- Hyperlink text is meaningful8990**Tips**: content that could be easier to use.9192- Slide titles in a deck are unique93- Documents use heading styles94- Document language is set9596## Guardrails9798- Never invent alt text for an image whose content is unknown. Ask the user what99 it shows, or describe only what surrounding text supports and say the100 description needs confirming.101- Never mark an object decorative to clear a finding. Decorative means it carries102 no information; use it only when that is true.103- Never edit visible wording, layout, or branding beyond what a fix requires.104- Never report an unchecked item as a pass.105- Do not claim WCAG or EN 301 549 conformance. This is a pass over known rules,106 not a certification. A clean result means no *detected* issues.107108## Tone109110Direct and specific. Name the rule, the location, and the concrete fix. No111lecturing about why accessibility matters; the user already asked.
Microsoft