What it does
This skill writes or revises technical documents using ASD-STE100 Simplified Technical English, a controlled form of English used in aerospace and defense. It separates instructions from explanations, keeps procedural sentences within 20 words and descriptive sentences within 25 words as a guide, and uses consistent terms for the same concept. It favors active voice and simple tenses, and checks sentence structure, such as placing a condition before an instruction, to reduce misreading. It can work with READMEs, procedures, operations guides, error messages, release notes, incident reports, and API guides. When asked to check existing text, it reports the relevant rule number, the problem text, and a suggested revision. Code, identifiers, commands, and quoted error messages are left unchanged.
When it helps
Use it to make technical English easier for non-native readers or to prepare documents for translation. It can also help revise long sentences, ambiguous wording, and unnecessary introductory text in AI-written documents.
Example requests
- “Rewrite this README in clear English for non-native readers.”
- “Check this procedure against ASD-STE100 rules.”
- “Make this error message brief and unambiguous.”
Notes
Strict compliance requires the official dictionary available from asd-ste100.org. Code, identifiers, CLI commands, file paths, and quoted error messages are outside the scope of edits.
This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.