← ClaudeAtlas

write-plain-englishlisted

Use when writing or editing prose that people read, such as documents, pull requests, commit messages, review comments, chat replies, or skills. Also use it when the user says "make this clearer", "simplify the wording", or "this is a wall of text". Rewrites the text in plain technical English, with one idea in each sentence and no dashes. Then runs a checker that reports long sentences and dashes. Not for checking code behavior (use `verify-and-review`).
theonly1me/shadowclone · ★ 26 · AI & Automation · score 85
Install: claude install-skill theonly1me/shadowclone
# Write Plain English ## Use when You write or edit any text that a person reads. Examples are a document, a pull request, a commit message, a review comment, a chat reply, and a skill. This skill is always on, so load it before you write. The rules come from ASD-STE100 Simplified Technical English, at about 80% strictness. Fix every checker error. Fix each warning, or keep it and give a reason. Clarity comes first. If a rule makes the text wrong or unclear, break the rule. ## Gates 1. Does each sentence carry one idea, with 20 words or fewer for an instruction and 25 or fewer for a description? 2. Is each instruction in the active voice, with the condition before the action? 3. Do you use one term for one thing, every time? 4. Is the text free of em dashes and en dashes? 5. Did you run `scripts/check-ste.mjs` on the text, fix every error, and fix or explain each warning? 6. Are code, commands, paths, and product names exactly as they were? ## Process Write in the user's voice. Before you write, read `~/.agents/voice.md`. If it does not exist, build it once from the user's merged pull requests, review comments, and commit messages. Use only text that the user wrote, and name those sources in your handoff. Never overwrite an existing or linked `voice.md`. 1. Put the main point first. Give the reader the result, then the reason. 2. Use common words that have one meaning. Use a single verb, not a phrasal verb: "start", not "kick off". 3. Keep the articles "the" and "a".