plain-language

Rewrite UI copy, error messages, and documentation into plain language.

39|2|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/mgifford/accessibility-skills --skill plain-language-mgifford
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plain-language
Source: https://github.com/mgifford/accessibility-skills/tree/main/skills/plain-language
Command: npx skills add https://github.com/mgifford/accessibility-skills --skill plain-language-mgifford

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Content written for general audiences is often dense with jargon, long sentences, and unexplained acronyms, creating cognitive barriers and exclusion for readers with diverse abilities.

Core Features & Use Cases

  • Enforces short, active sentences and plain words in UI copy, help text, error messages, and documentation.
  • Expands abbreviations on first use to aid screen readers and readers unfamiliar with terms.
  • Front-loads key information and uses a consistent structure to improve scan-ability across devices and AT.

Quick Start

Rewrite the provided content into plain language suitable for a general audience.

Frequently Asked Questions about plain-language

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write plain language content for UI copy and help text?

Improving content accessibility with plain language involves enforcing short, active sentences and front-loading key information. This approach avoids jargon and expands abbreviations on first use, ensuring help texts and documentation are clear for general audiences.

How do I expand abbreviations for screen readers in documentation?

Expanding abbreviations for screen readers in documentation requires applying plain-language criteria that spell out acronyms on first use. This ensures readers unfamiliar with terms and assistive technologies can parse the content without confusion.

What is the best way to simplify error messages for a general audience?

The best way to simplify error messages for a general audience is to use active voice and plain words. Applying plain-language principles ensures error messages avoid dense jargon and use a consistent structure to improve clarity across devices and assistive technologies.

Can I use plain-language principles to improve scan-ability in technical documentation?

Yes, you can use plain-language principles to improve scan-ability in technical documentation by front-loading key information and using a consistent structure. This removes cognitive barriers and ensures the text is accessible to readers with diverse abilities.

Why does rewriting jargon into active voice help content accessibility?

Rewriting jargon into active voice helps content accessibility because it enforces short, active sentences and plain words. This reduces cognitive barriers and exclusion for readers with diverse abilities who interact with your UI copy and help texts.