← All Skill Guides

Skill Guides · Weekly archive

Make technical instructions clearer with SimpleEnglish

A community repository applies controlled-language constraints to AI documentation workflows without claiming official compliance.

Week of Added September 8, 2026Office

Engineering teams looking to strip conversational padding from generated software documentation can use SimpleEnglish, an open-source writing skill structured around ASD-STE100 principles. Created by developer AminBlg, the project formats technical instructions into strict structural limits: sentences stay under 20 words for procedural steps and 25 words for descriptions, conditions precede commands, and hedging verbs like should or might are replaced with direct action terms.

The package targets technical documentation, incident postmortems, release notes, and error messages rather than general narrative prose or marketing copy. Rather than relying on open-ended clarity prompts, the skill asks the agent to follow single-meaning vocabulary rules and active voice across generated text. The repository notes that applying these constraints produces flat, functional instructions designed to avoid ambiguity, but it explicitly emphasizes that using the tool does not yield official ASD-STE100 certification, as ASD does not certify software tools.

Developers can install the configuration directly through the agent skills ecosystem using npx skills add AminBlg/SimpleEnglish, which configures environments such as Claude Code, Cursor, and Codex. For workflows lacking skill loader support, the repository provides standalone prompts in prompts/system-prompt.md to paste into system instructions, Custom GPT setups, or .cursorrules files.

The repository code and instructional text are distributed under an MIT license. The author notes that the project paraphrases structural rules and contains no proprietary specification text or official dictionary entries, operating independently without affiliation to or endorsement by ASD or the STEMG group.

Sources