plain-language

Solid

Load this skill whenever the project involves writing, editing, or reviewing content for a general audience, including UI copy, help text, error messages, documentation, and instructions. Under no circumstances use jargon, complex sentence structures, or unexplained acronyms without providing plain alternatives. Absolutely always target a reading level accessible to the broadest possible audience. Load alongside content-design/SKILL.md for all content work.

AI & Automation 35 stars 2 forks Updated today AGPL-3.0

Install

View on GitHub

Quality Score: 79/100

Stars 20%
52
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Plain Language Accessibility Skill > **Canonical source**: `examples/PLAIN_LANGUAGE_ACCESSIBILITY_BEST_PRACTICES.md` in `mgifford/ACCESSIBILITY.md` > This skill is derived from that file. When in doubt, the example is authoritative. Apply these rules when writing, editing, or reviewing web content. **Only load this skill if the project involves content creation or editing.** This skill complements `content-design/SKILL.md` — load both for content work. Plain language is the deeper implementation; content design is the structural pattern. --- ## Core Mandate Plain language means writing so that people can find what they need, understand it, and act on it the first time they read it. It is not about dumbing content down — it is about respecting the reader's time and removing unnecessary barriers. Plain language is the primary accessibility strategy for: - Users with cognitive disabilities, learning disabilities, and intellectual disabilities - Users with low literacy or whose first language is not the page language - Users who are stressed, fatigued, or in crisis - Users accessing content via screen reader, where re-reading is slow - Users in reader mode or using text-to-speech, where complex syntax breaks down WCAG 3.1.5 Reading Level (AAA) targets Grade 8 or lower for general audiences. Plain language is also an Opquast requirement (rules 5, 7) and aligns with the [Web Sustainability Guidelines](https://www.w3.org/TR/web-sustainability-guidelines/) — concise content...

Details

Author
mgifford
Repository
mgifford/accessibility-skills
Created
4 months ago
Last Updated
today
Language
JavaScript
License
AGPL-3.0

Similar Skills

Semantically similar based on skill content — not just same category

Web & Frontend Solid

content-design

Load this skill whenever writing, editing, or reviewing any web content, copy, headings, labels, error messages, or instructions. Under no circumstances write inaccessible content — every piece of text must be clear, structured, and usable by people with cognitive, visual, and language differences. Absolutely always apply plain language, logical heading hierarchy, and meaningful link text.

35 Updated today
mgifford
AI & Automation Solid

plain-speak

Translate technical jargon, code concepts, or dense engineering text into plain language a non-technical colleague or manager can follow. Use when the user asks to "explain in plain language", "白話文", "翻成人話", "用白話解釋", "explain like I'm a PM", "make this non-technical", "simplify this term", "what does this term mean", or pastes technical text and asks for a business-audience version, or asks you to review/check whether an existing plain-language draft lands for a non-technical reader ("這樣夠白話嗎", "幫我看 非技術主管看不看得懂", "is this clear enough for a PM"). Reply in the language the user wrote in. Do NOT invoke for removing AI-isms / 潤飾語氣 from existing prose (use avoid-ai-writing-zh), for structuring a whole formal business document — 簽呈/會議紀錄/報告 (use formal-doc-structure), or for RFP / 需求規格書 / 招標規格 (use rfp-writing). This skill lowers the audience, not the voice, the structure, or the document type.

0 Updated today
leoluyi
AI & Automation Listed

readability

This skill should be used when writing or revising web content, product copy, AI-generated responses, docs, or long-form text where clarity, scannability, and comprehension matter.

0 Updated 2 days ago
mickzijdel