simplified-english

Write user-facing comments, plans, and documents in ASD-STE100 Simplified Technical English — short, unambiguous sentences with approved words and one meaning each — so readers understand them the first time.

  • writing
  • communication
  • clarity
  • style
Install
npx skills add 'https://github.com/paperclipai/paperclip/tree/master/packages/skills-catalog/catalog/optional/content/simplified-english'
Download bundle ↓
master · 5b913e7Scanned 2026-09-15

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗

SKILL.md

SKILL.mdBrowse 1 file
View on GitHub

Simplified English

For user-facing comments, plans, and documents, write using only ASD-STE100 Simplified Technical English.

Core rules

  • Use short sentences (procedures ≤ 20 words, descriptions ≤ 25 words).
  • Give one instruction per sentence.
  • Use approved words with one meaning each; avoid synonyms and jargon.
  • Use the active voice and the present tense.
  • Use articles ("the", "a") and do not drop words to save space.
  • Write positive instructions; avoid negative or vague qualifiers.
  • Keep paragraphs to one topic.

Approved words

The approved words are the ASD-STE100 controlled vocabulary — the Dictionary in the current ASD-STE100 specification, plus the technical names and technical verbs that your subject needs. When a word is not approved, use the simplest common word that has one meaning. Prefer these house choices:

  • "start" / "stop" (not "initiate", "commence", "terminate", "kill")
  • "make" (not "implement", "leverage", "utilize")
  • "before" / "after" (not "prior to", "subsequent to")
  • "about" (not "regarding", "in relation to")
  • "help" (not "facilitate")
  • "use" (not "utilize", "employ")
Discovery context

Discovered by repository scan. No exact path reference found in the snapshot’s root AGENTS.md.