# Writing For Accessibility

> Accessible content writing including plain language, reading level, and cognitive accessibility in text.

- Skill: `dragoon0x/writing-for-accessibility` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dragoon0x/writing-for-accessibility`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dragoon0x/writing-for-accessibility/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: dragoon0x (https://skillmd.com/u/dragoon0x)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/dragoon0x/writing-for-accessibility

---


# Writing For Accessibility

## Plain Language Rules

1. **Short sentences.** Average 15-20 words.
2. **Common words.** "Use" not "utilize." "Start" not "commence."
3. **Active voice.** "We send your report" not "Your report will be sent."
4. **One idea per paragraph.**
5. **Define jargon** on first use.

## Reading Level
- Target: 8th grade reading level for general audiences.
- Tools: Hemingway Editor, Flesch-Kincaid score.
- Medical/financial: provide plain-language summaries alongside technical content.

## Structural Accessibility
- Descriptive headings (not clever ones).
- Lists for 3+ related items.
- Tables for comparative data (with proper headers).
- Alt text for meaningful images.
- Link text that makes sense out of context ("Download the report" not "Click here").

## Cognitive Load
- Chunk information into small pieces.
- Use consistent terminology (don't switch between "workspace" and "project").
- Provide examples alongside instructions.
- Allow undo instead of requiring confirmation.