What problem does it solve?
Branches in the dlt repository accumulate inconsistent terminology, long sentences, and non-compliant prose across docstrings, comments, error messages, and documentation. This Skill audits a branch diff against dlt's fixed vocabulary and the 53 rules of ASD-STE100 Simplified Technical English, then rewrites the prose so the project says one thing one way.
Core Features & Use Cases
- Vocabulary enforcement: Applies grouped fixed-vocabulary tables (data access, attach, transformations, identifiers, configuration) with explicit banned terms and legal exceptions.
- STE rule compliance: Classifies text as procedural or descriptive, enforces 20/25-word sentence limits, condition-first commands, and one instruction per sentence.
- Safe multi-phase workflow: Audits first with file:line findings, waits for approval, then applies edits in two phases and verifies with AST comparison, linting, formatting, and test runs.
- Use Case: A maintainer runs /review-vocabulary on a feature branch before merge; the Skill proposes rewrites for docstrings and error messages, flags test assertions that would break, and applies approved changes without touching code.
Quick Start
Ask the assistant to run /review-vocabulary against the current branch to audit and rewrite its prose against dlt's vocabulary and Simplified Technical English rules.
