ste-clarity
Installation
SKILL.md
STE Clarity — Simplified Technical English rewriting and linting
ASD-STE100 is a controlled language the aerospace industry built so maintenance instructions cannot be misread. It removes the two main sources of misreading: words with more than one meaning and sentences with more than one possible structure. This skill applies that discipline to everyday technical prose — tool descriptions, error messages, prompts, READMEs, status reports — for readers who cannot ask a follow-up question: a downstream agent, a translation pipeline, or a person skimming under time pressure.
Pick the level
| Level | When | What changes |
|---|---|---|
| Standard (default) | Explanations, READMEs, PR descriptions, changelogs, reviews, status reports | Enforce all structural rules. Treat lexical rules (fixed vocabulary) as advisory: prefer plain words and consistent terms, but allow reasonable range. |
| Strict | Procedures, error messages, tool/function descriptions, inter-agent instructions, safety text; or the user says "strict", "100%", "full STE" | Enforce everything, including hard length caps, one-word-one-meaning, no contractions, no Latin abbreviations. |
Infer the level from the text type when the user does not say. Do not announce the level unless the user asks for the rule table.