wtf is clear-english?

Clear English is a set of writing rules that makes an AI coding assistant reply in simpler, plainer English without changing the actual meaning of what it says. It is aimed at people whose first language is not English, since AI replies often contain long sentences, unexplained jargon, idioms, and vague hype words that do not carry any real information. The rules work by preferring the common everyday word over a fancier one, such as saying use instead of utilize, and start instead of initiate. They break long, stacked sentences into one idea per sentence, and if a technical term has to appear, they define it once in plain words and then keep using it normally. Instead of vague categories like edge cases, the rules ask for concrete real examples, such as an empty list or a name with an apostrophe. Idioms and hype language are avoided entirely, while code, commands, and error text are always left exact and never reworded. The project supports four AI coding tools: Claude Code, Codex CLI, Cursor, and Gemini CLI. Each tool reads the same set of rules from a different file in a different location that matches how that particular tool expects its instructions, such as a SKILL.md file for Claude Code, an AGENTS.md file for Codex CLI, a rules file inside a .cursor folder for Cursor, and a GEMINI.md file for Gemini CLI. In Claude Code specifically, you can either trigger it manually with a slash command or turn it on permanently by adding one line to your Claude instructions file so it applies to every explanation automatically. Setup for each tool involves copying the matching file from this repository into the correct folder on your machine, which differs slightly between macOS, Linux, and Windows paths. The project is made by a developer named Soumya and is released under the MIT license.