git404hub

what is clear-english fr?

sho-das/clear-english — explained in plain English

Analysis updated 2026-05-18

2Audience · vibe coderComplexity · 1/5LicenseSetup · easy

tl;dr

A shared set of writing rules that makes Claude Code, Codex CLI, Cursor, and Gemini CLI explain things in simpler, plainer English while keeping every fact exact.

vibe map

mindmap
  root((clear english))
    What it does
      Simplifies AI wording
      Keeps facts exact
      Removes jargon and idioms
    Tech stack
      Claude Code SKILL
      Codex AGENTS file
      Cursor rules
      Gemini config
    Use cases
      Non native speakers
      Plain English replies
      Always on writing style
    Rules
      Common words first
      One idea per sentence
      Define terms once
      Real examples not categories

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Make Claude Code, Codex CLI, Cursor, or Gemini CLI explain things in simpler English.

VIBE 2

Help a non-native English speaker read AI coding explanations without losing technical accuracy.

VIBE 3

Set a permanent plain-English writing style for all of an AI assistant's prose replies.

what's the stack?

MarkdownClaude CodeCodex CLICursorGemini CLI

how it stacks up fr

sho-das/clear-english0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPython
Setup difficultyeasymoderateeasy
Complexity1/52/52/5
Audiencevibe codergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min
MIT license, free to use, modify, and share.

in plain 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.

prompts (copy fr)

prompt 1
Install the clear-english skill for Claude Code and turn it on by default in my CLAUDE.md.
prompt 2
Copy the clear-english rules into my Cursor project's .cursor/rules folder.
prompt 3
Rewrite this AI explanation using the clear-english rules: keep every fact but use simpler words.
prompt 4
Set up clear-english for Codex CLI so it reads the rules on every run.

Frequently asked questions

what is clear-english fr?

A shared set of writing rules that makes Claude Code, Codex CLI, Cursor, and Gemini CLI explain things in simpler, plainer English while keeping every fact exact.

What license does clear-english use?

MIT license, free to use, modify, and share.

How hard is clear-english to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is clear-english for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.