Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
owl-listener avatar

Plain Language Design

  • 44 installs
  • 87 repo stars
  • Updated June 9, 2026
  • owl-listener/inclusive-design-skills

Helps with ai & agent building tasks during AI-assisted development.

About

plain-language-design is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted coding.

  • plain-language-design
  • AI & Agent Building
  • AI-coding skill

Plain Language Design by the numbers

  • 44 all-time installs (skills.sh)
  • +7 installs in the week ending Aug 4, 2026 (Skillselion tracking)
  • Ranked #7,851 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/owl-listener/inclusive-design-skills --skill plain-language-design

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs44
repo stars87
Last updatedJune 9, 2026
Repositoryowl-listener/inclusive-design-skills

What it does

Helps with ai & agent building tasks during AI-assisted development.

Files

SKILL.mdMarkdownGitHub ↗

Plain Language Design

Write and evaluate content so that people with cognitive disabilities, low literacy, non-native language skills, or high stress can understand it on the first read.

Plain language is not dumbed-down language. It is clear language. It respects the reader's time and cognitive resources.

The Tests

5-Second Test

Can someone read this sentence and understand it in 5 seconds? If not, rewrite.

Jargon Test

Would someone outside your industry understand every word? If not, replace the word or define it inline.

Action Test

For any instruction or button: is the next step completely unambiguous? "Save and continue" beats "Next". "Delete this item" beats "Remove".

Passive Voice Test

Passive voice hides who does what. "Your application has been rejected" → "We could not approve your application. Here's what to do next."

Sentence Length Test

  • Aim for 15–20 words per sentence maximum
  • One idea per sentence
  • One instruction per paragraph

Common Replacements

Instead ofUse
utiliseuse
facilitatehelp
implementset up / start
terminateend / stop
prior tobefore
in order toto
at this point in timenow
in the event thatif
with regard toabout
commencestart
sufficientenough
subsequentnext
indicateshow / tell
modifychange

Readability Benchmarks

  • General public: grade 6–8 reading level
  • Specialist audience: define terms, short sentences
  • Critical content (medical, legal, financial): plain language summary

alongside the full text

  • Buttons, labels, error messages: grade 4–6 always

How to Review

1. Read every piece of text aloud — stumbles reveal complexity 2. Check sentence length (count words — flag any over 25) 3. Identify jargon, acronyms, and idioms 4. Verify every instruction has a clear, single action 5. Check that error messages say: what happened + why + what to do

Output Format

When reviewing: present a table of flagged text with the original, the issue, and a rewritten version. When writing: produce plain language content with a note on the target reading level achieved.

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.