01
It starts by itself
docs change in PR. Runs in GitHub Actions or Claude Code routine.
- ↻ docs change in PR
pull_request paths: **/*.md
aminblg · 13K installsSimple English skill
Runs by itself, every time you change a doc.
Every doc stays easy to read.
Install the Simple English skill and make it a habit: follow https://gethabit.dev/skills/aminblg/simple-english.md
- 1Copy
- 2Paste into Claude Code, Codex or Cursor
- 3It runs by itself
13K installs4K starsMIT licenceSource on GitHub ↗
Simple English
by aminblg · 13K installs
The skill
Rewrites docs in short, plain English.
Only when you ask.
Clearer docs
Every doc stays easy to read. More people understand your work.
↻ Runs by itselfevery time you change a doc
How the habit works.
You don't have to.
When does it start? How does it check its work? What does it remember?
One run, step by step.
Then it stops.
Stops after 10 changed files or 2 retries per file.
- 01
Find changed docs
The run collects the documentation files that the pull request changed.
- 02
Check the text
In CHECK mode the agent opens references/rule-catalog.md and lists each violation with its rule number and a rewrite.
- 03
Pick the mode
For runbooks, release notes or error messages the agent reads references/use-cases.md first, and Strict mode only applies when you name STE.
- 04
Rewrite the prose
The agent rewrites the prose with short active sentences and leaves code, commands and facts as they are.
- 05
Run the self-check
The agent searches for the banned marks and words and counts the longest sentences, then fixes each hit.
- 06
Log the run
The run writes each file and its remaining hits into the run log.
What it may do.
Nothing more.
It writes only in its own folder and asks you before anything goes out.
- Writes only in**/*.md, loops/simple-english-docs-loop/**
- Talks tono outside service
- Sendsnothing
- Your OKNothing goes out, so it needs no OK.
Is it for you?
Use it when it fits.
Read both lists. If the left one sounds like you, the Simple English skill helps.
Use it when
- ✓ You write READMEs or runbooks
- ✓ Readers are non-native speakers
- ✓ You want AI slop removed
Skip it when
- – You write marketing or brand copy
- – You need certified STE compliance
Simple English skill, answered.
Does the loop change my code?
No. Code, identifiers, commands, flags, file paths and quoted errors stay as they are.
Does it make my docs STE compliant?
No tool can promise that. Strict mode applies the STE vocabulary, and the skill says so once.
Can I use it for marketing copy?
The skill says no, because its rules remove persuasion. Use it for docs and instructions.
How do I install the Simple English skill?
Copy the prompt at the top into your agent. It installs the skill from aminblg/simpleenglish and sets up the habit. Or run npx skills add aminblg/simpleenglish --skill simple-english.
Is the Simple English skill free?
Yes. It is published under MIT. Habit is free too.
Simple English. Now as a habit.
Install the Simple English skill and make it a habit: follow https://gethabit.dev/skills/aminblg/simple-english.md
All aminblg skills →More docs skills →
Works in
- Claude Code
- Codex
- Cursor
- ChatGPT
- Claude app
Made by aminblg, published under MIT. Habit links to the original and never changes it. Is this your skill?