ste100
Skill0 starsChanged 26 days agoMITView on GitHub
Apply ASD-STE100 Simplified Technical English (STE) — the aerospace and defense controlled-language standard — to technical writing: procedures, descriptions, maintenance records, and safety warnings. Use when Shane says: "apply STE100 to this", "apply STE to this", "simplified technical english", "make this STE-compliant", "review for ASD-STE100", "STE check this", "rewrite this as a procedure in STE". Also invoke proactively when reviewing step-by-step instructions, work cards, or safety-critical warnings that must be unambiguous for a non-native-English reader.
10 other projects use a version of this.
Adopted by
Most recently taken up by
- whyashthakker/estacktheir own version, first seen Nov 8, 2026
- uprinter/ai-agents-teamtheir own version, first seen Nov 8, 2026
- toonooby/ste100-plugintheir own version, first seen Oct 20, 2026
- beingDurgesh/asd-ste100-simplified-technical-english-agent-skilltheir own version, first seen Oct 17, 2026
- hugobatista/agent-skillstheir own version, first seen Sep 20, 2026
- zcaceres/skillstheir own version, first seen Aug 19, 2026
Other versions10 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 10
- zcaceres/skills★ 7same name
- beingDurgesh/asd-ste100-simplified-technical-english-agent-skill★ 4same name
- weselben/RooForge★ 4same name
- SpillwaveSolutions/ste100-agent-plugins★ 2same name
- hiteshbandhu/skills-i-use★ 1same name
- hugobatista/agent-skills★ 1same name
- uprinter/ai-agents-team★ 1same name
- DevDizzle/gammarips-harness★ 0same name
- toonooby/ste100-plugin★ 0same name
- whyashthakker/estack★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository5 other files it gives its agents.
- humanizeSkill
- ms-style-passSkill
- plain-languageSkill
- writing-interviewSkill
- writing-reviewSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
13 rules. 0 are common, 12 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 10 edited versions we read keep these.
12
Distinctive
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 15
Use only STE-approved words with their approved meanings.
- Distinctive: line 18
Prefer the approved short form of a concept over a longer or figurative one ("use," not "utilize".
- Distinctive: line 28
Active voice: Use it by default. Passive is permitted only when the agent is unknown or genuinely irrelevant (e.g., "The unit is calibrated …
- Very specific: line 30
No ambiguous participles: Avoid -ing and -ed participle phrases that a reader could parse either as a modifier or as the main verb.
- Distinctive: line 31
Subject–verb agreement, and short noun clusters: Every verb agrees with its subject.
- Distinctive: line 32
Write positively: Prefer "Use X" over "Do not use Y" — *except* for safety, where a prohibition must be stated explicitly and directly.
- Distinctive: line 42
Put the warning before the step it protects, never after.
- Distinctive: line 43
Every safety statement must survive rule 5 (no ambiguous participles) and rule 1 (length) — but never sacrifice explicitness to hit a word …
- Distinctive: line 64
Always: call out safety statements (WARNING / CAUTION / NOTE) that need STE attention, separately from ordinary changes — safety language …
- Distinctive: line 68
Don't assert a word is STE-approved when you cannot verify it — flag it instead.
- Distinctive: line 69
Don't strip a technical name or technical verb to satisfy vocabulary control.
- Distinctive: line 70
Don't shorten a safety warning below the length needed to stay unambiguous.
- Distinctive: line 71
Don't apply STE to prose that isn't technical documentation (marketing copy, narrative) unless Shane explicitly asks — STE is deliberately …
“Common” is measured: kept by at least 6 in 10 of the 10 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
ASD-STE100 (Simplified Technical English)
ASD-STE100 (formerly AECMA Simplified English) is a controlled-language standard for technical documentation. It exists so that a procedure written by one person is understood the same way by every reader — including non-native English speakers and, increasingly, machine translation.
Two things are controlled: vocabulary (which words you may use and what each means) and grammar/style (how you build sentences). Apply both.
Vocabulary control
- Use only STE-approved words with their approved meanings. When you flag an unapproved word, suggest an approved substitute in the same context.
- One word = one meaning. A word listed with an approved part of speech and sense must be used only that way. Do not use a word that carries multiple meanings unless STE explicitly permits the sense you need. Example: "follow" is approved only in the sense of "come after" — for "obey the instructions," use "obey."
- Technical names and technical verbs are always permitted. Part names, system names, tool names, materials, and standardized technical verbs (e.g., "solder," "drill") are nouns/verbs you keep even if not in the general dictionary. Name the thing; don't paraphrase it.
- Prefer the approved short form of a concept over a longer or figurative one ("use," not "utilize"; "start," not "initiate").
You do not have the full ~900-word dictionary loaded here. When you cannot verify a word's approval status, flag it as needs verification rather than asserting it is approved — say which sense you intend and offer the most likely approved substitute.
Writing rules
These are the highest-value rules. Apply them in order of impact.
- Sentence length. Procedural (step) sentences: maximum 20 words. Descriptive sentences: maximum 25 words. Count and split anything over.
- One instruction per sentence in procedures. If a step contains two actions ("Remove the panel and disconnect the cable"), split it into two steps — unless the two actions are done together as one operation, in which case say so explicitly.
- Active voice. Use it by default. Passive is permitted only when the agent is unknown or genuinely irrelevant (e.g., "The unit is calibrated at the factory").
- Simple verb tenses. Simple present for descriptions. Imperative for procedures ("Open the valve"). Simple past for maintenance records ("Replaced the filter"). No perfect/continuous/conditional stacks.
- No ambiguous participles. Avoid
-ingand-edparticiple phrases that a reader could parse either as a modifier or as the main verb. "The pump running at full speed is hot" → "The pump is hot when it runs at full speed." - Subject–verb agreement, and short noun clusters. Every verb agrees with its subject. Maximum 3 nouns in a cluster — break up strings like "main engine fuel supply shutoff valve" ("the shutoff valve for the main-engine fuel supply").
- Write positively. Prefer "Use X" over "Do not use Y" — except for safety, where a prohibition must be stated explicitly and directly.
- Paragraphs: one topic each, maximum 6 sentences. One idea per paragraph. Start with a topic sentence.
- Define abbreviations and acronyms at first use in the document. Spell out, then give the abbreviation in parentheses. After that, use the abbreviation consistently.
Safety warnings
STE treats safety language as the highest-stakes text in the document. Give it extra scrutiny.
- Distinguish the three levels correctly: WARNING (risk of injury or death to people), CAUTION (risk of damage to equipment), NOTE (important information, no hazard).
- A warning must state the hazard and the action, unambiguously. "Do not touch the terminal" is weak; "WARNING: High voltage. Do not touch the terminal. You can get an electric shock." names hazard, prohibition, and consequence.
- Put the warning before the step it protects, never after.
- Every safety statement must survive rule 5 (no ambiguous participles) and rule 1 (length) — but never sacrifice explicitness to hit a word count. If a warning needs 22 words to be unambiguous, keep 22 and flag it.
Behavior
Reviewing or rewriting supplied text — return, in this order:
- Corrected version. STE-compliant text, ready to use.
- Changes made. A short list; for each change name the rule number it satisfies.
**STE changes:**
- Split a 31-word step into two steps (rule 1, rule 2)
- "utilize" → "use" (vocabulary: approved short form)
- Passive "the bolt should be tightened" → "Tighten the bolt" (rule 3, rule 4)
- Noun cluster "engine fuel supply line" kept — 3 nouns, at the limit (rule 6)
- "actuate" flagged — needs verification against the STE dictionary; likely "operate" or "start"
- WARNING moved above the step it protects; added the consequence clause (safety)Drafting new content — produce STE-compliant text directly. State whether the content is procedural (20-word limit) or descriptive (25-word limit) so the reader knows which constraint applied.
Always call out safety statements (WARNING / CAUTION / NOTE) that need STE attention, separately from ordinary changes — safety language must be the most unambiguous text in the document.
What not to do
- Don't assert a word is STE-approved when you cannot verify it — flag it instead.
- Don't strip a technical name or technical verb to satisfy vocabulary control; those are always permitted.
- Don't shorten a safety warning below the length needed to stay unambiguous.
- Don't apply STE to prose that isn't technical documentation (marketing copy, narrative) unless Shane explicitly asks — STE is deliberately austere and will flatten voice.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

