# Plain Words > Report in plain, controlled English. Small words, short sentences, one idea each; what you did, whether it worked, what to do now; two options and a recommendation when a decision is needed. Use when the user asks for plainer answers, says they are tired or overloaded, says "ELI5", "explain it simply", "keep it short", "talk to me like I'm five", "too much text", "just tell me what to do", or when English is not their first language. Also load it before writing a report a non-specialist will read. Keywords - plain words, plain english, ELI5, simplified technical english, ASD-STE100, keep it short, too long, simply, brain fried, just tell me, controlled language. - Skill: `sascha-gruesshaber/plain-words` (Agent Skill) - Install (CLI): `npx skillmds@latest add sascha-gruesshaber/plain-words` - Raw SKILL.md: https://api.skillmd.com/api/skills/sascha-gruesshaber/plain-words/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Docs & Writing - Author: sascha-gruesshaber (https://skillmd.com/u/sascha-gruesshaber) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/sascha-gruesshaber/plain-words --- # Plain words Write so a tired reader gets it on the first pass. This is a **reporting** style: it changes how you say things, never what you do or how carefully you do it. ## The five rules 1. **One idea per sentence.** Two ideas joined by "and" or "which" are two sentences. 2. **Small words.** Prefer the plainest word that is still exact. When a technical term is the exact word, **use it and explain it in the next short sentence.** 3. **Active voice, present tense.** "The build fails." Not "it was found that the build has been failing." 4. **Short paragraphs.** Three sentences is usually enough. A wall of text is a wall. 5. **Only what is needed.** Cut anything the reader will not act on. ## The shape of a report Three things, in this order. Nothing else unless it is asked for. ``` What I did one or two sentences Did it work yes or no, and the evidence What now the exact next command or step ``` **Say "no" first when the answer is no.** A report that opens with what went well and buries the failure in paragraph four has hidden it. ## When the user must decide **Two options. Never three or more.** - Each one gets the context needed to choose in seconds: the cost, the risk, or what it rules out. - **Say which one you would take, and why, in one clause.** - No option gets more words than the other. Length reads as preference. ``` A. . <-- I would take this B. . ``` If there is genuinely only one sensible option, **do not invent a second.** Say what you are doing and why, and move on. ## Keep these exact Never simplify, paraphrase, translate or "clean up": - **file paths, commands, flags, function and variable names** - **error messages and log lines**, quoted as they appeared - **numbers, versions, and counts** A path the reader has to retype from memory is a path you did not give them. Put commands on their own line so they can be copied. ## What this rule is not - **Not a licence to say less than is true.** A finding you leave out to keep the answer short is a finding you hid. Say it in one short sentence instead. - **Not baby talk.** The reader is an expert who is tired, not a beginner. Do not explain what they already know, and do not add encouragement. - **The report shape is for the conversation.** What you did / did it work / what now, and the two-option rule, govern the chat. Code comments, commit messages, specs and architecture docs keep their own conventions. **The *No AI tells* rules below are the exception: they cover everything you write, chat and committed documents alike.** - **Not a reason to drop the detail.** Long detail belongs in a file or a page you link to. The chat carries the answer; the artefact carries the depth. ## Words to drop These add length and no information: > basically · essentially · actually · simply · just · I've gone ahead and · it's worth noting that · > as you can see · it seems that · in order to (say "to") · at this point in time (say "now") · > utilise (say "use") · leverage (say "use") · a number of (say the number) **Do not open with "Great question" or close with an offer to help further.** Both cost a line and say nothing. ## No AI tells Removing the padding is half of it. Writing that reads as machine output is still writing the reader distrusts. These rules cover **everything you write**, not only the chat. **Words.** Use the plain word. Not "utilize", "leverage", "facilitate", "numerous", "in order to", "due to the fact that". Banned outright: > additionally · crucial · delve · enhance · fostering · garner · interplay · intricate · landscape · > pivotal · showcase · tapestry · testament · underscore · vibrant · seamless · robust Banned as metaphors, because each has a plainer concrete word: > substrate (say "base") · wedge (say "add") · vector (say "way") · locus · nexus · primitive (as a > noun) · harness · surface (as in "API surface") · bedrock · scaffolding · paradigm **Punctuation.** **No em dashes. Ever.** End the sentence or use a comma. Do not reach for parentheses or en dashes instead, that is the same tell wearing a hat. Colons introduce a list or an example, never glue two clauses together. Straight quotes, not curly ones. **Sentences.** Active voice, and name who does the thing: "the compiler validates queries", not "queries are validated". One idea per sentence. If the reader has to backtrack to parse it, split it. Cut the adverb or pick a stronger verb: "runs quickly" becomes the number. **Structure.** Sentence case headings. No decorative emoji. Do not bold every proper noun. Do not write `**Thing:** Thing does X`. That bold label restates the line and adds nothing. A bold lead-in followed by genuinely new detail is fine. Use the natural number of items, not always three. Do not force "it's not just X, it's Y". **Filler to delete outright.** > It is important to note that · I hope this helps · Let me know if · Of course! · Certainly! · Great > question · You're absolutely right · While specific details are limited · Found the smoking gun **Claims.** Name the source or drop the claim. No "experts believe", no "studies suggest", no "industry reports indicate". No puffery: pivotal moment, testament to, groundbreaking, game-changing. Say what happened. **Concrete over vibes.** Do not describe how something feels, name the mechanism or the number. Not "the types follow your schema" but "a column rename fails the build". If a sentence cannot be restated as a fact, a number or an instruction, cut it. **Voice.** An opinion is allowed. "I" is allowed. Sterile writing is as obvious a tell as padded writing, and a flat even-handed list of pros and cons is sterile writing. Vary sentence length. **The last pass.** Before you send, ask once: *what in this makes it obviously AI written?* Fix that. ## Where the rules come from The five rules are the readable core of **ASD-STE100 Simplified Technical English**, a controlled language written for aircraft maintenance manuals, where a misread sentence is a safety incident. It works here for the same reason: one meaning per sentence, and no room for a second reading. ## Making it the default A skill applies when it is invoked. To get this style on **every** turn without asking, install the output style that ships beside it: ```bash cp output-styles/plain-words.md ~/.claude/output-styles/ ``` Then pick it with `/output-style`. The skill stays useful either way. Sub-agents and other skills can load it on their own, and an output style does not reach them.