ste100
Skill1 starsChanged 24 days agoMITView on GitHub
Write and review English technical documentation in ASD-STE100 Simplified Technical English — sentence-length limits, one instruction per sentence, imperative procedures, active voice, approved verb forms, noun clusters of three words at most, six-sentence paragraphs, and safety notes that start with a command. Use for README files, runbooks, ADRs, spec.md, plan.md, and docs/ pages in a target project. Does not apply to UI strings (use ux-copy), to personal posts or outreach published under a person's own name, to legal text, or to non-English text.
11 other projects use a version of this.
Adopted by
Most recently taken up by
- Free-cat/simplified-technical-englishtheir own version, first seen Nov 15, 2026
- slogsdon/skills-writingtheir own version, first seen Nov 12, 2026
- whyashthakker/estacktheir 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
Other versions11 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 11
- zcaceres/skills★ 7same name
- beingDurgesh/asd-ste100-simplified-technical-english-agent-skill★ 4same name
- weselben/RooForge★ 4same name
- Free-cat/simplified-technical-english★ 2same name
- SpillwaveSolutions/ste100-agent-plugins★ 2same name
- hiteshbandhu/skills-i-use★ 1same name
- hugobatista/agent-skills★ 1same name
- DevDizzle/gammarips-harness★ 0same name
- slogsdon/skills-writing★ 0same name
- toonooby/ste100-plugin★ 0same name
1 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 repository18 other files it gives its agents.
- AGENTS.mdAGENTS.md
- context7-cliSkill
- decision-protocolSkill
- frontend-designSkill
- gitlab-accessSkill
- hallmarkSkill
- harness-cleanerSkill
- image-genSkill
- k8s-debugSkill
- retroSkill
- sdd-workflowSkill
- teammate-protocolSkill
- team-wikiSkill
- technical-seoSkill
- ux-copySkill
- vector-genSkill
- web-design-guidelinesSkill
- writing-for-agentsSkill
The file
We split this skill into the rules it gives an agent
11 rules. 0 are common, 9 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 11 edited versions we read keep these.
9
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 35
Use one word for one meaning: Use the same term for the same thing in the full document.
- Distinctive: line 36
Use a word only in its usual part of speech: Do not make a noun into a verb ("to action", "to task").
- Distinctive: line 41
Write one instruction per sentence: If two actions must occur at the same time, put them in one sentence.
- Distinctive: line 43
Number the steps of a procedure: Use one numbered step for each action.
- Distinctive: line 46
Do not use a vague pronoun: If "it" or "this" can refer to two things, repeat the noun.
- Very specific: line 51
Start with a short, clear command.
- Distinctive: line 52
Put the note before the step that it applies to.
- Very specific: line 56
Run .claude/skills/ste100/scripts/ste100-check.sh <file>...
- Distinctive: line 60
Read each numbered step. Each step has one action.
- Distinctive: line 69
Before (39 words, conditional at the end, passive, "-ing", "should"):
- Distinctive: line 73
After (procedure, 3 steps, each under 20 words):
“Common” is measured: kept by at least 6 in 10 of the 11 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 for docs
ASD-STE100 is the controlled-language standard of ASD (Aerospace, Security and Defence Industries Association of Europe). The current edition is Issue 9, January 2025: 53 writing rules plus a dictionary of about 900 approved words. The standard is free on request from ASD, and ASD owns the copyright. This skill restates the writing rules in summary. It does not copy the dictionary, and it never claims a word is "approved" or "not approved" from memory.
Scope
Apply STE to English prose in a target project's documentation: README*, runbooks, ADRs, spec.md, plan.md, tasks.md prose, and docs/ pages.
Do not apply STE to:
- UI strings —
ux-copyowns them. - Personal posts or outreach published under a person's own name.
- Legal, consent, and licence text.
- Code, code blocks, commands, command output, log lines, quoted error messages, identifiers, file paths, and quotations from other sources.
- Non-English text.
Two kinds of text
Classify each block before you write it. The rules differ.
| Procedure (an instruction) | Description (an explanation) | |
| Sentence length | 20 words maximum | 25 words maximum |
| Verb form | Imperative: "Restart the pod." | Simple present, past, or future |
| Unit | One instruction per sentence | One topic per paragraph, 6 sentences maximum |
Code spans and identifiers count as one word each.
Writing rules
- Use one word for one meaning. Use the same term for the same thing in the full document. Do not use a synonym for variety. If the project has a glossary, use its terms.
- Use a word only in its usual part of speech. Do not make a noun into a verb ("to action", "to task").
- Technical names and technical verbs are permitted. Names of products, services, commands, APIs, files, and settings are technical names. Verbs that name a specific technical process (deploy, merge, rebase, provision) are technical verbs. For all other words, use the shortest common word: "use", not "utilize"; "start", not "commence"; "help", not "facilitate".
- Use these verb forms only: infinitive, imperative, simple present, simple past, simple future, and the past participle as an adjective ("the deployed version"). Do not use "-ing" forms, except in a technical name ("load balancing"). Do not use "should", "could", or "would" in a procedure. Write "must" or give the command.
- Use the active voice. In a procedure, always. In a description, use the passive only when the agent is not known or not important.
- Keep noun clusters to three words maximum. Change "cluster node pool upgrade policy" to "the upgrade policy for the node pool".
- Write one instruction per sentence. If two actions must occur at the same time, put them in one sentence.
- Put a condition before the instruction. "If the job fails, restart it." Not: "Restart the job if it fails."
- Number the steps of a procedure. Use one numbered step for each action. Show the result of a step after the step, not inside it.
- Put the most important information first in a sentence and in a paragraph.
- Use articles and "that" where they make the sentence clear. Do not remove them to save words.
- Do not use a vague pronoun. If "it" or "this" can refer to two things, repeat the noun.
Warnings and cautions
- A warning tells the reader about a risk to people or data. A caution tells the reader about a risk to equipment or service.
- Start with a short, clear command. Then give the reason in one sentence. Example: "Do not run
terraform destroyon the shared state. This command deletes the production cluster." - Put the note before the step that it applies to.
Self-check before you open the MR
- Run
.claude/skills/ste100/scripts/ste100-check.sh <file>...from this repository (-pfor a procedure file) on every prose file you touched, and fix every line it reports before you push. Three authors missed the length rule by hand and paid two to four review rounds per MR (→ RP-49). - Count the words in each sentence the script cannot split. Procedure: 20 maximum. Description: 25 maximum.
- Find each "-ing" word, each passive verb, and each "should". Rewrite each one, or confirm that it is a permitted exception.
- Count the sentences in each paragraph. Six is the maximum.
- Read each numbered step. Each step has one action.
- Find each noun cluster with more than three words. Rewrite it.
In review
The reviewer runs the same script on the touched files first and cites its output. The reviewer records a docs finding in the REVIEW-ATTESTATION for each touched prose file. A finding names the file, the rule number from this skill, and the sentence. A sentence over its length limit, more than one instruction in one sentence, or a procedure that is not in the imperative is a blocking finding. A long word with a common short equivalent is a nit.
Example
Before (39 words, conditional at the end, passive, "-ing", "should"):
"The migration should be run by the operator after verifying that the backup has been successfully completed, and the application pods should be scaled down before starting it, otherwise data written during the migration might be lost."
After (procedure, 3 steps, each under 20 words):
- Make sure that the backup is complete.
- Scale the application pods to zero.
- Run the migration.
Warning: Do not run the migration while the pods run. The migration can lose new data.
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.

