simple-english
Simple English: Write Like an Aerospace Manual
Write technical text with the rules of ASD-STE100 Simplified Technical English. STE is the controlled language that aerospace and defense manufacturers use for maintenance documentation. The rules exist so that a tired reader who is not a native English speaker cannot misread an instruction. They remove the usual signs of AI-generated text as a side effect: long sentences, synonym rotation, hedges, filler, and decorative clauses.
Write for that tired reader. Each sentence must survive one read.
How to use it in Hermes
The text usually arrives one of three ways:
- Inline. The user pastes the text into the message. Rewrite it in place and reply with the result.
- File. The user points at a file (README, runbook, docs page). Use
read_fileto load it, thenpatchfor targeted section rewrites orwrite_filefor a full rewrite. Never touch code blocks, identifiers, or quoted errors (see Untouchables). - Check mode. The user asks you to audit text for STE compliance instead of rewriting it. Report each violation as rule number + offending text + compliant rewrite, using
references/checklist.md.
This skill differs from humanizer: humanizer restores natural human voice; simple-english enforces a controlled language for technical instructions. For docs, runbooks, and error messages use this skill. For blog posts, essays, and personal writing use humanizer. Do not apply both to the same text.
Your Task
When asked to write or rewrite technical text: