simplified-technical-english
Skill2 starsChanged 4 months agoMITView on GitHub
Use when writing, revising, or checking procedures, maintenance instructions, safety notices, product documentation, or technical explanations under ASD-STE100 for international readers.
19 other projects use a version of this.
Adopted by
Most recently taken up by
- therealmarzouq/skillstheir own version, first seen Nov 8, 2026
- cicorias/skillstheir own version, first seen Nov 8, 2026
- gabrielbauman/skillstheir own version, first seen Nov 1, 2026
- ask-marcel/ask-marcel-office-clitheir own version, first seen Nov 1, 2026
- superplanehq/superplanetheir own version, first seen Oct 26, 2026
- thomast1906/github-copilot-agent-skillstheir own version, first seen Oct 25, 2026
Other versions19 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 19
- superplanehq/superplane★ 9.1ksame name
- thomast1906/github-copilot-agent-skills★ 203same name
- OpenHands/extensions★ 167same name
- jpcaparas/skills★ 53same name
- Cyberger877241/agent-skill-simplified-technical-english★ 48same name
- menonpg/ste-prompt★ 18same name
- adeerkhan/vitruvius★ 10same name
- ask-marcel/ask-marcel-office-cli★ 9same name
- DotDebian/asd-ste100-skill★ 8same name
- 0xpili/simplified-technical-english★ 4same name
9 more not listed
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 repository8 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- compressed-deliberationSkill
- de-slopSkill
- navigable-referencesSkill
- proportionate-executionSkill
- subagent-returnsSkill
- plain-languageSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
31 rules. 0 are common, 29 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 19 edited versions we read keep these.
29
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 10
Write technical content that is accurate, direct, consistent, and difficult to misunderstand.
- Distinctive: line 21
Read rule-navigation.md when an exact rule location, more context, or strict compliance matters.
- Distinctive: line 22
Read examples.md when you need before-and-after patterns for a revision or explanation.
- Distinctive: line 23
Treat both references as aids.
- Distinctive: line 27
Use approved STE words when the dictionary is available.
- Distinctive: line 28
Use each approved word only with its approved meaning, part of speech, and form.
- Distinctive: line 29
Use necessary technical nouns and verbs accepted by the relevant organization or field.
- Distinctive: line 30
Use one term for one item.
- Distinctive: line 31
Avoid slang, jargon, regional wording, idioms, and phrasal verbs.
- Distinctive: line 32
Use American English spelling unless an official requirement specifies otherwise.
- Distinctive: line 37
Keep multi-word nouns to three words or fewer.
- Distinctive: line 38
When an official term is longer, write it in full first.
- Distinctive: line 39
Prefer prepositions or relative clauses to long noun stacks.
- Very specific: line 40
Use a, an, the, this, or these where needed.
- Distinctive: line 44
Use active voice and name the actor.
- Distinctive: line 45
Use a verb to express an action, not an abstract noun phrase.
- Distinctive: line 46
Use only the infinitive, imperative, simple present, simple past, simple future, and permitted past-participle forms.
- Distinctive: line 47
Avoid complex auxiliary constructions.
- Very specific: line 49
Use an -ing form only as an accepted technical noun or modifier in a technical noun.
- Distinctive: line 53
Write complete, direct sentences.
- Distinctive: line 54
Put one main idea in each sentence.
- Distinctive: line 55
Use a vertical list for several conditions, items, or actions.
- Distinctive: line 56
Use explicit connecting words when the relation between sentences is not clear.
- Distinctive: line 57
Do not use semicolons.
- Distinctive: line 61
Use no more than 20 words in a sentence.
- Distinctive: line 62
Put one instruction in each sentence, except when actions occur simultaneously.
- Distinctive: line 64
Put a necessary condition before the command and separate it with a comma.
- Distinctive: line 65
Use notes for information only.
- Distinctive: line 78
Start with a clear command or condition.
- Distinctive: line 91
no simplification creates ambiguity.
- Distinctive: line 103
Every statement above is accounted for in a public trace.
“Common” is measured: kept by at least 6 in 10 of the 19 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
Simplified Technical English
Purpose
Write technical content that is accurate, direct, consistent, and difficult to misunderstand. This compact guide is based on ASD-STE100 Issue 9. It does not replace the official standard or controlled dictionary.
Priorities
- Preserve technical meaning and safety.
- Remove ambiguity.
- Use consistent terminology.
- Reduce length only when clarity remains intact.
Reference routing
- Read rule-navigation.md when an exact rule location, more context, or strict compliance matters.
- Read examples.md when you need before-and-after patterns for a revision or explanation.
- Treat both references as aids. For strict compliance, check the official PDF, its controlled dictionary, and the applicable terminology database.
Vocabulary
- Use approved STE words when the dictionary is available.
- Use each approved word only with its approved meaning, part of speech, and form.
- Use necessary technical nouns and verbs accepted by the relevant organization or field.
- Use one term for one item. Do not alternate between synonyms.
- Avoid slang, jargon, regional wording, idioms, and phrasal verbs.
- Use American English spelling unless an official requirement specifies otherwise.
- Rewrite the sentence when a word-for-word substitution is not clear.
Nouns
- Keep multi-word nouns to three words or fewer.
- When an official term is longer, write it in full first. Then define a clear short form or use hyphens to mark words that function as one unit.
- Prefer prepositions or relative clauses to long noun stacks.
- Use
a,an,the,this, orthesewhere needed.
Verbs
- Use active voice and name the actor.
- Use a verb to express an action, not an abstract noun phrase.
- Use only the infinitive, imperative, simple present, simple past, simple future, and permitted past-participle forms.
- Avoid complex auxiliary constructions.
- In descriptive text, use passive voice only when the actor is unknown.
- Use an
-ingform only as an accepted technical noun or modifier in a technical noun.
Sentences and lists
- Write complete, direct sentences. Do not use contractions or omit necessary words.
- Put one main idea in each sentence.
- Use a vertical list for several conditions, items, or actions.
- Use explicit connecting words when the relation between sentences is not clear.
- Do not use semicolons.
Procedures
- Use no more than 20 words in a sentence.
- Put one instruction in each sentence, except when actions occur simultaneously.
- Begin an instruction with an imperative verb:
Remove,Install,Measure. - Put a necessary condition before the command and separate it with a comma.
- Use notes for information only. Do not put instructions in notes.
Descriptions
- Use no more than 25 words in a sentence.
- Give information gradually, from general context to specific detail.
- Give each paragraph one topic and no more than six sentences.
- Repeat key terms when repetition prevents ambiguity.
Safety instructions
- Identify the risk level with the approved signal word or symbol.
- In ASD usage, a warning identifies risk of injury or death. A caution identifies risk of damage to objects.
- Start with a clear command or condition.
- State the hazard or possible result explicitly.
Final check
Confirm that:
- each instruction has one clear action.
- each pronoun has one clear referent.
- each item has one consistent name.
- sentence and paragraph limits are met.
- safety consequences are explicit.
- units, identifiers, labels, quotations, and technical facts are unchanged.
- no simplification creates ambiguity.
For strict compliance, check every general word against the official dictionary and every technical term against the applicable terminology database.
Source and boundary
This skill is an operational digest. It states the rules in our own words, and it carries no part of the standard large enough to replace it. Read the official document for the complete rule, its explanation, and its dictionary entries.
Standard: ASD-STE100 Simplified Technical English, Issue 9 (2025)
Every statement above is accounted for in a public trace. Each one either cites a numbered rule in the standard, or is marked as our own editorial guidance, or is marked as narrative that asserts no rule. The trace lives in the stylewright repository. It is not installed with this skill, because it is an audit record for a reader and not context for an agent.
Notice
This skill is not affiliated with, endorsed by, or approved by ASD. ASD-STE100
and Simplified Technical English are European Union registered trademarks owned
by the Aerospace, Security and Defence Industries Association of Europe, number
017966390.
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.

