gitwtfhub

wtf is simpleenglish?

aminblg/simpleenglish — explained in plain English

Analysis updated 2026-08-13

2,280PythonAudience · developerComplexity · 1/5LicenseSetup · easy

TL;DR

An agent skill that forces AI models to write documentation in a controlled, unambiguous style based on aerospace's ASD-STE100 standard.

Mindmap

mindmap
  root((SimpleEnglish))
    What it does
      Controlled technical writing rules
      Removes vague AI phrasing
      Works across many coding tools
    Tech stack
      Python
      Agent Skills standard
      Claude Code plugin
    Use cases
      Rewrite AI generated docs
      Write clearer error messages
      Draft plain incident reports
    Audience
      Developers
      Vibe coders
      Writers

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

Why would anyone build with this?

REASON 1

Rewrite vague AI-generated documentation into short, direct instructions

REASON 2

Turn a generic error message into a clear statement of what failed and how to fix it

REASON 3

Write incident reports and runbooks in a plain, unambiguous style

REASON 4

Set an always-on writing style for Claude Code that follows controlled English rules

What's in the stack?

PythonAgent SkillsClaude Code

How it stacks up

aminblg/simpleenglishshepherd-agents/shepherdamap-cvlab/abot-world
Stars2,2802,2902,295
LanguagePythonPythonPython
Setup difficultyeasymoderatehard
Complexity1/54/55/5
Audiencedeveloperdeveloperresearcher

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

How do you spin it up?

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

Wtf does this do

SimpleEnglish is an agent skill that forces AI models to write documentation in ASD-STE100 Simplified Technical English, a controlled form of English that the aerospace industry has used since 1983 so a tired mechanic cannot misread an instruction. The project's pitch is that following these rules also removes most of the vague, padded, marketing sounding writing that AI models tend to produce by default. The README shows several before and after examples using real Claude output. A sentence that originally described a tool using fancy language to automatically move data between systems becomes a short, direct statement of what the tool does and what you need to set up first. An error message that apologizes for inconvenience and asks you to try again becomes a specific statement of what failed and how to fix it. The rules behind these rewrites include limits like twenty words per instruction, using only one word for one meaning throughout a document, sticking to simple verb tenses, avoiding words like should, would, may, and might, and putting a condition before the command it applies to rather than after. It works as an Agent Skill, a standard supported by many coding tools including Claude Code, Cursor, VS Code Copilot, OpenAI Codex, Gemini CLI, and roughly two dozen others. Installing it is a single command using the skills command line tool, or it can be added as a Claude Code plugin, or set as an always on output style inside Claude Code so all of its writing follows these rules. For tools that do not support the Agent Skills format, the repository includes a plain system prompt file that can be pasted into a system prompt, an AGENTS.md file, or custom instructions for tools like ChatGPT or Gemini. Beyond documentation, the skill also includes adapted rule sets for error messages, runbooks, and incident reports, each following a similar what happened, why, and what to do structure. The project is released under the MIT license and includes benchmark results claiming a large measured reduction in rule violations across six different Claude models.

Yoink these prompts

Prompt 1
Install the SimpleEnglish skill with npx skills add AminBlg/SimpleEnglish and rewrite my README with it
Prompt 2
Using SimpleEnglish, rewrite this error message to state what happened, why, and what to do
Prompt 3
Show me the SimpleEnglish rule for putting conditions before commands, with an example
Prompt 4
Set up SimpleEnglish as an output style in Claude Code so all my documentation follows it

Frequently asked questions

wtf is simpleenglish?

An agent skill that forces AI models to write documentation in a controlled, unambiguous style based on aerospace's ASD-STE100 standard.

What language is simpleenglish written in?

Mainly Python. The stack also includes Python, Agent Skills, Claude Code.

What license does simpleenglish use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is simpleenglish to set up?

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

Who is simpleenglish for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.