Simple English
Skill
Writes and rewrites technical documentation in plain English, with an optional Strict mode based on ASD-STE100 Simplified Technical English.
By Vedang Manerikar · git:github.com/vedang/SimpleEnglish · View source
What it does
Simple English helps readers outside the field understand technical text. It uses short sentences, active voice, consistent terms, and definitions before unfamiliar concepts.
Plain mode is the default. Asking for STE, ASD-STE100, or compliance selects Strict mode, which adds vocabulary rules. Both modes preserve code, commands, paths, product names, and facts.
When to reach for it
Invocation: Ask the agent to write or rewrite documentation in plain English, or run /skill:simple-english. Ask for ASD-STE100 compliance to select Strict mode.
- Writing documentation for readers outside the field
- Explain technical terms before use and give each procedural sentence one instruction.
- Rewriting a README, runbook, or error message
- Remove filler and simplify the prose without changing commands or facts.
What it adds
- Plain and Strict writing modes, plus a self-review checklist.
- Reference guides for vocabulary, document types, and reviews against ASD-STE100 rules.
Commands: /skill:simple-english
How it fits
- Sharpen Communication — Sharpen Communication clarifies audience and message structure. Simple English supplies sentence and vocabulary rules for technical prose.
Good to know
- This skill is part of my normal startup packages, not the occasional-use catalog behind /load-skill.
- My Pi settings record version 2.1.1 for this package.
- No tool guarantees ASD-STE100 compliance. Review Strict-mode output against the standard.
- The rules target factual documentation and instructions, not marketing or brand copy.
Source and setup
- Loaded via
git:github.com/vedang/SimpleEnglish- Attribution
- By Vedang Manerikar