This skill rewrites complex technical text into plain, layman-readable English. By prioritizing active voice, short sentences, and a one-word-one-meaning approach, it removes jargon and AI-generated filler from critical documentation.
It is designed for technical writers and developer experience engineers drafting READMEs, API guides, runbooks, and incident reports. The skill can operate in a general plain mode or a strict compliance mode based on the ASD-STE100 standard used in aerospace maintenance manuals.
Follow the documented setup, then try a first task.
Installs: The Simple English skill only; this option does not install the session hook or output style. · Claude Code, Cursor, VS Code Copilot, OpenAI Codex, Gemini CLI, Goose, OpenCode
In a terminal, add the SimpleEnglish repository with the skills CLI.
npx skills add AminBlg/SimpleEnglish
Installs: The Simple English Claude Code plugin, including its session hook, advisory writing-check hooks, and output style. · Claude Code
In a terminal, add the marketplace and install the Simple English plugin.
claude plugin marketplace add AminBlg/SimpleEnglish && claude plugin install simple-english@simple-english
In a Claude Code session, enter `/config` and select `simple-english:simple-english` under Output style. Alternatively, put `{"outputStyle": "simple-english:simple-english"}` in `~/.claude/settings.json`.
Installs: The Simple English Codex plugin, including the skill and session hook. · OpenAI Codex
In a terminal, add the marketplace and then add the Simple English plugin.
codex plugin marketplace add AminBlg/SimpleEnglish codex plugin add simple-english@simple-english
Before the hook runs for the first time, review it. In a Codex session, enter `/hooks` and approve the hook when prompted.
Uses simple-english
Use the simple-english skill in its default Plain mode to rewrite the following technical text for a reader outside the field: [paste the technical text here]. Preserve all code, identifiers, commands, flags, file paths, quoted errors, product names, and facts.
Claude
Codex
Cursor
Gemini CLI
Copilot
Amp
OpenCode
Goose