agentleFS
rookslogrookslog/stylewright/skills/standards/simplified-technical-english/SKILL.md

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

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
  1. Distinctive:

    Write technical content that is accurate, direct, consistent, and difficult to misunderstand.

    line 10
  2. Distinctive:

    Read rule-navigation.md when an exact rule location, more context, or strict compliance matters.

    line 21
  3. Distinctive:

    Read examples.md when you need before-and-after patterns for a revision or explanation.

    line 22
  4. Distinctive:

    Treat both references as aids.

    line 23
  5. Distinctive:

    Use approved STE words when the dictionary is available.

    line 27
  6. Distinctive:

    Use each approved word only with its approved meaning, part of speech, and form.

    line 28
  7. Distinctive:

    Use necessary technical nouns and verbs accepted by the relevant organization or field.

    line 29
  8. Distinctive:

    Use one term for one item.

    line 30
  9. Distinctive:

    Avoid slang, jargon, regional wording, idioms, and phrasal verbs.

    line 31
  10. Distinctive:

    Use American English spelling unless an official requirement specifies otherwise.

    line 32
  11. Distinctive:

    Keep multi-word nouns to three words or fewer.

    line 37
  12. Distinctive:

    When an official term is longer, write it in full first.

    line 38
  13. Distinctive:

    Prefer prepositions or relative clauses to long noun stacks.

    line 39
  14. Very specific:

    Use a, an, the, this, or these where needed.

    line 40
  15. Distinctive:

    Use active voice and name the actor.

    line 44
  16. Distinctive:

    Use a verb to express an action, not an abstract noun phrase.

    line 45
  17. Distinctive:

    Use only the infinitive, imperative, simple present, simple past, simple future, and permitted past-participle forms.

    line 46
  18. Distinctive:

    Avoid complex auxiliary constructions.

    line 47
  19. Very specific:

    Use an -ing form only as an accepted technical noun or modifier in a technical noun.

    line 49
  20. Distinctive:

    Write complete, direct sentences.

    line 53
  21. Distinctive:

    Put one main idea in each sentence.

    line 54
  22. Distinctive:

    Use a vertical list for several conditions, items, or actions.

    line 55
  23. Distinctive:

    Use explicit connecting words when the relation between sentences is not clear.

    line 56
  24. Distinctive:

    Do not use semicolons.

    line 57
  25. Distinctive:

    Use no more than 20 words in a sentence.

    line 61
  26. Distinctive:

    Put one instruction in each sentence, except when actions occur simultaneously.

    line 62
  27. Distinctive:

    Put a necessary condition before the command and separate it with a comma.

    line 64
  28. Distinctive:

    Use notes for information only.

    line 65
  29. Distinctive:

    Start with a clear command or condition.

    line 78
  30. Distinctive:

    no simplification creates ambiguity.

    line 91
  31. Distinctive:

    Every statement above is accounted for in a public trace.

    line 103

“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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

  1. Preserve technical meaning and safety.
  2. Remove ambiguity.
  3. Use consistent terminology.
  4. 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, or these where 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 -ing form 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.