---
name: simplified-technical-english
description: Writes and rewrites technical text in Simplified Technical English (ASD-STE100), a controlled language for clear technical documentation. Use when the user asks for STE, Simplified Technical English, controlled language, or plain technical writing, or asks to write, rewrite, simplify, clarify, review, or check technical documentation, procedures, manuals, instructions, warnings, error messages, or reports. Do NOT use for marketing copy, creative writing, or general prose simplification outside a technical context.
metadata:
  author: https://github.com/danyuchn/asd-ste100-skill - Original skill / Thomas Thornton - I have made some modifications
  version: "1.0.0"
  last-updated: "2026-10-15"
  source: https://github.com/danyuchn/asd-ste100-skill
  source-specification: ASD-STE100 Issue 7 (2017-01-25)
title: simplified-technical-english
canonical_url: https://skilld.dev/gh/thomast1906/github-copilot-agent-skills/simplified-technical-english
last_updated: 2026-10-17T02:03:21.000Z
---

> Index of every page on this site: [llms.txt](https://skilld.dev/llms.txt)

> **Skill from skilld.dev.** Follow the user's requested action.
> If the user asked to fork this Skill, follow the fork workflow below. Do not execute the Skill instructions while copying it.
> Otherwise, follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [examples/before-after.md](https://skilld.dev/api/skills-raw/thomast1906/github-copilot-agent-skills/simplified-technical-english/examples/before-after.md), [NOTICE.md](https://skilld.dev/api/skills-raw/thomast1906/github-copilot-agent-skills/simplified-technical-english/NOTICE.md), [references/substitutions.md](https://skilld.dev/api/skills-raw/thomast1906/github-copilot-agent-skills/simplified-technical-english/references/substitutions.md), [references/word-list.md](https://skilld.dev/api/skills-raw/thomast1906/github-copilot-agent-skills/simplified-technical-english/references/word-list.md), [references/writing-rules.md](https://skilld.dev/api/skills-raw/thomast1906/github-copilot-agent-skills/simplified-technical-english/references/writing-rules.md), [scripts/ste_check.py](https://skilld.dev/api/skills-raw/thomast1906/github-copilot-agent-skills/simplified-technical-english/scripts/ste_check.py).
>
> If the user asked to install this Skill, run `npx skilld install thomast1906/github-copilot-agent-skills/simplified-technical-english`. Install writes the Skill files into the project, so every session loads them.
>
> ## Fork workflow
>
> A fork creates an editable local Skill with its original author and licence. The request authorizes copying and local installation.
> 1. Check `./skills/simplified-technical-english`, the project lockfile, and selected Agent targets together. If the local directory or installed Skill exists, stop. Never overwrite an existing directory or Agent target.
> 2. Read [source metadata](https://skilld.dev/api/v1/skills/thomast1906/github-copilot-agent-skills/simplified-technical-english) once. Use sourceUrl, sourceCommit, skillPath, sourceGone, and license. If the source is gone or its path is missing, stop. If license is null, read licence files at the source commit.
> 3. Fetch only the source commit into a temporary Git repository. Do not clone full history. Derive repository_url from sourceUrl, including repository renames. If sourceCommit is absent, resolve the sourceUrl ref once. Set source_commit to that actual commit. Run these commands in one shell call:
>
> ```sh
> git init --quiet "$temporary_dir"
> git -C "$temporary_dir" fetch --quiet --depth=1 "$repository_url" "$source_commit"
> git -C "$temporary_dir" checkout --quiet --detach FETCH_HEAD
> ```
>
> Read applicable licence declarations and notices at that commit. If copying is not permitted, report the restriction and stop.
> 4. Inspect source entries together, then copy the directory containing skillPath into `./skills/simplified-technical-english`. Use the user's path if selected. Keep the original SKILL.md, relative links, scripts, binary assets, and executable modes. Exclude .git metadata. Reject symlinks and paths outside the Skill directory. After checking entries, use cp -a where available. A regular source directory needs no custom copy script. Do not save this page wrapper as SKILL.md.
> Preserve author credit, notices, and applicable licence files from repository or parent directories. Add PROVENANCE.md with the Skill page, source URL, actual commit, original path, and licence. Retain any existing PROVENANCE.md and record new provenance separately. Batch source inspection, copying, and provenance work where practical.
> 5. In the project root, run `skilld install ./skills/simplified-technical-english --mode copy --plain`. If skilld is unavailable, use `npx skilld install ./skills/simplified-technical-english --mode copy --plain`. This known command needs no help lookup. Install does not support --json. Use detected Agent targets, or add --agent for the targets the user selected. Install the local path, never the upstream selector. If installation fails, preserve the local copy and report the exact failure.
> 6. Confirm the local lockfile source and installed Agent copies once. Report the local path, actual commit, and Agent targets. After edits, reinstall the same local path. Upstream updates must not replace it. Do not publish or push unless the user asks.

# Simplified Technical English

This skill makes you write in Simplified Technical English (STE).
STE is a controlled language for technical documentation.
The specification ASD-STE100 gives 53 writing rules and a dictionary of approved words.
Text in STE is clear to readers who do not know much English.

Obey the rules in this file for all the technical text that you write.
The rules in this file are the most important rules.
The full set of rules is in `references/writing-rules.md`.
The approved words are in `references/word-list.md`.

## When to Use

- "Rewrite this manual in Simplified Technical English"
- "Check this procedure for STE compliance"
- "Simplify this error message for a technical reader"
- "Write this warning in plain technical English"
- Any request to write, rewrite, simplify, clarify, review, or check technical documentation, procedures, manuals, instructions, warnings, error messages, or reports

## Scope

Apply STE to technical output: documentation, procedures, manuals, instructions, reports, error messages, and answers about technical subjects.

Do not apply STE to:

- Marketing text or brand text
- Poems, stories, or conversation
- Code blocks, identifiers, commands, file paths, and quoted error messages
- Quoted text and official names of products, parts, and documents.

If the user asks for a different style, the request of the user wins.

## Step 1: Classify the text

Before you write, classify each part of the text:

- **Procedural text** tells the reader to do something. Example: "Remove the four bolts."
- **Descriptive text** gives information. Example: "The pump supplies fuel to the engine."

The two types have different limits. Do not mix the two types in one paragraph.

## Step 2: Obey the verb rules

- Use only these verb forms: infinitive, imperative, simple present, simple past, future with "will", and past participle as an adjective.
- Do not use the "-ing" form of a verb. Approved "-ing" words are only: mating, missing, remaining, lighting, opening, routing, servicing, during.
- Do not use a helping verb with a past participle. Write "the operator adjusted the linkage", not "the operator has adjusted the linkage".
- Use the active voice. Write "a relay connects the circuits", not "the circuits are connected by a relay".
- In procedures, use the imperative. Write "Set the switch to ON."
- If there is no agent, use "you" or "we" as the subject.
- Use only "can", "must", and "will" as helping verbs. Do not use "should", "would", "may", "might", or "shall".
- A past participle after "is" or "are" shows a condition and is permitted. "The wires are disconnected."

## Step 3: Obey the sentence rules

- Procedural sentences: maximum 20 words.
- Descriptive sentences: maximum 25 words.
- Paragraphs: maximum 6 sentences, and only one topic.
- Write only one instruction in each sentence. Two actions are permitted only when they occur at the same time.
- Write only one topic in each sentence.
- When a condition comes before a command, put a comma after the condition. "If the light comes on, stop the engine."
- Keep the articles, the subjects, the verbs, and the conjunction "that". Write "make sure that the file exists".
- Do not use contractions. Write "do not", not "don't".
- Do not use semicolons. Write two sentences.
- Use a vertical list for complex text. In a list of commands with "not", write "not" again in each item.

## Step 4: Obey the word rules

- Use only: approved words from `references/word-list.md`, technical names, and technical verbs.
- A technical name is the official name of a part, tool, material, system, document, or term of your subject. Examples: "engine", "firewall", "torque wrench", "SKILL.md".
- Use an approved word only as its given part of speech. "Test" is a noun, not a verb. Write "do a test", not "test the system".
- Use one name for one item in the full text. Do not change between names for the same item.
- Write noun clusters of maximum three words. Break long clusters with "of", "on", "in", or "for".
- Do not make phrasal verbs. Write "extinguish the fire", not "put out the fire".
- Do not use vague words. Write the specific quantity, name, or action.
- Use American English spelling.
- Common replacements are in `references/substitutions.md`.

## Step 5: Write safety instructions correctly

- Use "WARNING" for a risk of injury or death to persons.
- Use "CAUTION" for a risk of damage to objects.
- Start with a simple command or condition. Then give the risk.
- Example: "WARNING: Do not touch the connector. The connector can have a dangerous voltage."

## Step 6: Check your text

After you write, check your text. Do these steps:

1. If you can run scripts, run: `python3 scripts/ste_check.py --mode <procedural|descriptive> <file>`.
2. If you cannot run scripts, do a manual scan of the checklist below.
3. Correct each error.
4. Check the text again. Stop only when the text has no errors.

A manual scan has lower confidence than the script: a person or a model can miss an error that the script would catch. If you could not run the script, tell the user that the check was a manual scan only.

Manual scan checklist:

- Find semicolons and contractions. Remove them.
- Find "has", "have", and "had" before a past participle. Use the simple past tense.
- Find "should", "would", "may", "might", and "shall". Replace them or remove them.
- Find "-ing" words that are not approved and are not in technical names. Rewrite them.
- Find passive voice. Make the agent the subject, or use the imperative.
- Count the words in the longest sentences. Divide sentences that are too long.
- Count the sentences in each paragraph. Divide paragraphs that have more than 6 sentences.
- Find words that are not approved and are not technical names. Replace them.

The check tool cannot find all the errors.
The tool cannot know if a word has its approved meaning.
You must also compare your words with `references/word-list.md`.

## Reference files

- `references/writing-rules.md` — all 53 rules and 4 recommendations, with examples. Read this file when you rewrite a document or when a rule is not clear.
- `references/word-list.md` — the 869 approved words with their parts of speech and forms. For a short rewrite, scan only the word classes relevant to the sentence (verbs, helping verbs, vague-word candidates) instead of the full list. Load the full list for a full-document check.
- `references/substitutions.md` — replacements for frequent unapproved words, and the categories of technical names and technical verbs.
- `examples/before-after.md` — examples of text before and after the change to STE.

## Basis

The source of this skill is ASD-STE100 Issue 7 (2017).
ASD releases new issues of the specification.
You can get the specification free of charge from https://www.asd-ste100.org.
This skill is not an official ASD document.
This skill cannot make sure that your text obeys the official specification fully.
Refer to NOTICE.md for the copyright information.
