simple-english

Rewrite technical prose under ASD-STE100 rules and lint drafts for form-slop markers.

7|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/apoapostolov/humanizer --skill simple-english-apoapostolov
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: simple-english
Source: https://github.com/apoapostolov/humanizer/tree/main/skills/simple-english
Command: npx skills add https://github.com/apoapostolov/humanizer --skill simple-english-apoapostolov

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Technical documentation, error messages, and runbooks often contain vague modals, marketing filler, long sentences, and inconsistent terminology that confuse readers and translators. This Skill rewrites such prose under ASD-STE100 (Simplified Technical English) rules and provides a deterministic Python linter to measure mechanical slop markers per 100 words. ## Core Features & Use Cases - Two control modes: Strict mode enforces every STE rule (20-word instructions, no contractions, approved modals only) for procedures and safety text; STE-flavored mode applies plain words and direct syntax to reference docs and PR descriptions. - Deterministic voice linter: scripts/voice_lint.py reports violations per 100 words across categories like long sentences, passive voice, banned words, marketing adjectives, and em dashes, plus report-only rhythm and AI-slop tells. - Use Case: An engineer drafts a runbook with sentences like "You should ensure the configuration is properly initialized." The Skill rewrites it to condition-first imperatives ("If the build fails, read the log"), collapses synonym rotations (check/verify/ensure into one term), and the linter confirms the violation rate dropped. ## Quick Start Ask the agent to rewrite your technical draft in simplified English using the simple-english skill and then lint it with scripts/voice_lint.py.

Frequently Asked Questions about simple-english

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I rewrite technical documentation in Simplified Technical English?▼

Classify each passage as procedural or descriptive, then apply the STE rules: one instruction per sentence, 20-word limit for instructions, approved modals only (can, will, must), and condition-first phrasing. Run scripts/voice_lint.py on the draft to measure remaining violations per 100 words.

What is the difference between strict mode and STE-flavored mode?▼

Strict mode enforces every ASD-STE100 rule including length caps, no contractions, and approved vocabulary for procedures and safety text. STE-flavored mode applies plain words and direct syntax to reference docs and PRs, where length and contraction findings require judgment rather than automatic rewrites.

How do I run the STE linter on a Markdown draft?▼

Run python3 scripts/voice_lint.py path/to/draft.md from the skill directory, or pipe text via stdin. The script outputs word count, total violations, violations per 100 words, and em dash counts, with no external dependencies required.

Does the voice linter guarantee ASD-STE100 compliance?▼

No, the linter is heuristic and not a certified STE checker. It measures mechanical form markers like banned words and passive voice, but judgment rules such as correct technical nouns require a human. Final approval rests with the writer.

When should I not use Simplified Technical English?▼

Avoid STE for marketing pages, brand writing, fiction, personal essays, and any section whose job is to persuade or carry a distinct voice, since STE strips voice on purpose. Use a natural-voice rewrite skill like humanizer for those sections instead.

Can STE rules apply to error messages and AI agent prompts?▼

Yes, error messages follow the pattern of stating what happened, the cause, then the fix as an imperative. Agent instructions are treated as procedures: one instruction per sentence, no "should" since models read it as optional, and conditions placed first.