Agent skill · nousresearch

simple-english

Rewrite text to ASD-STE100 Simplified Technical English.

What it needs

About 14k tokens when loaded.

What this skill does

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: 1. Inline. The user pastes the text into the message. Rewrite it in place and reply with the result. 2. File. The user points at a file (README, runbook, docs page). Use readfile to load it, then patch for targeted section rewrites or writefile for a full rewrite. Never touch code blocks, identifiers, or quoted errors (see Untouchables). 3. 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: 1. Select the mode (pragmatic or strict, below). 2. Classify each passage as procedural or descriptive. Every other rule depends on this. 3. Correct your vocabulary before drafting. In strict mode, use make sure that for the check/verify/confirm/ensure concept — the dictionary rejects all four as verbs. In pragmatic mode, pick one and keep it. Pick ONE noun for config/settings (all are valid technical nouns — pick one and keep it). …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills nousresearch/simple-english

View the source on GitHub

Browse the @skills marketplace