The project's README from github.com/0xpili/simplified-technical-english. As one markdown file: README.md.
This skill makes an LLM write in Simplified Technical English (STE). STE is a controlled language for technical documentation. The specification ASD-STE100 gives the rules of STE and its dictionary. The aerospace and defense industries use STE for their manuals. Text in STE is clear, short, and easy to translate.
The skill obeys the rules that it gives. This README is in STE.
Text before the change:
Prior to commencing the installation, it should be ensured that all components have been thoroughly inspected for damage.
Text after the change:
Before you start the installation, examine all the components for damage.
| File | Function |
|---|---|
SKILL.md |
The primary instructions for the LLM |
references/writing-rules.md |
The 53 writing rules, with examples |
references/word-list.md |
The 869 approved words |
references/substitutions.md |
Replacements for frequent unapproved words |
examples/before-after.md |
Examples of text before and after the change |
scripts/ste_check.py |
A check tool for the STE rules |
NOTICE.md |
Copyright information |
Clone this repository into your skills folder:
git clone https://github.com/0xpili/simplified-technical-english.git ~/.claude/skills/simplified-technical-english
Tell Claude to write or examine technical text in STE.
Claude finds the skill and obeys the rules.
You can also start the skill directly. Type /simplified-technical-english.
SKILL.md. Copy its text into the system prompt of the LLM.references/substitutions.md.references/word-list.md.Run the check tool on a file or on standard input:
python3 scripts/ste_check.py --mode procedural draft.txt
python3 scripts/ste_check.py --mode descriptive chapter.md
The tool finds these errors:
The tool uses only Python 3. The tool shows each error and its rule number.
The tool cannot find all the errors. The tool cannot know if a word has its approved meaning. A person who knows STE must also examine an important text. This skill is not an official ASD document. This skill cannot make sure that your text obeys the official specification fully.
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.
The dictionary of ASD-STE100 is the property of ASD. Refer to NOTICE.md.
The text of this skill and its scripts have the MIT license. Refer to LICENSE.