What problem does it solve?
Technical documentation often contains long sentences, ambiguous vocabulary, and inconsistent terminology that confuse readers and translators. This Skill rewrites prose to follow ASD-STE100 Simplified Technical English rules, producing controlled, unambiguous text.
Core Features & Use Cases
- Rule-based rewriting: Enforces sentence length limits (20 words procedural, 25 descriptive), approved verb forms, active voice, and one-meaning-per-word vocabulary.
- Word substitution dictionary: Ships a reference table mapping unapproved words (utilize, ensure, prior to) to approved alternatives (use, make sure, before).
- Warnings and cautions formatting: Structures WARNING, CAUTION, and NOTE blocks with command-first ordering per the standard.
- Use Case: Rewrite a software maintenance runbook so every procedure uses imperative sentences under 20 words, consistent terminology, and properly formatted cautions.
Quick Start
Use the ste skill to rewrite the attached maintenance procedure in Simplified Technical English.