plain-language
Write in plain language per the US Plain Writing Act of 2010 and the Plain Language Action Network. Use when the user wants clearer, simpler, shorter writing; wants to improve readability; writes public-facing or government-style content; or asks to "plain English" or "simplify" a draft.
Install
With your agent
Install OMGSkills skill "surendranb/writing-skills:skills/plain-language" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/surendranb/writing-skills /tmp/writing-skills && ln -s /tmp/writing-skills/skills/plain-language ~/.claude/skills/plain-languageFrom README
Plain Language Clear, direct, useful. The reader gets it on one read. The core rule Write so your reader can find, understand, and use what they need on the first read. Plain language is not dumbing down — it is removing obstacles: wordiness, passive construction, jargon, and buried logic. Workflow: decide who the reader is and what they must do → front-load the key point → cut every word that is not doing work → run the verification checklist. Mechanics Front-load the point. First sentence states the purpose, conclusion, or action. No throat-clearing. Short sentences. Average 15–20 words; hard cap 25. One idea per sentence. Active voice. Subject acts: "The team shipped the fix" not "The fix was shipped by the team." Reserve passive for when the actor is truly unknown or irrelevant. Common words. Plain terms over Latinates: "use" not "utilize", "end" not "terminate", "ask" not "request". Actionable verbs. Name the action: "we will refund you" not "a refund will be issued".
More from this repo
asd-ste100
Used when writing technical procedures, instructions, warnings, maintenance manuals, or any text where every reader...
business-writing
Used to write executive-grade business communication with BLUF (bottom line up front), active verbs, and zero buzzwords.
corporate-communication
Used to write internal corporate communications — announcements, org changes, policy updates, launch messages — with...