mcpbeat Sign in

Simplified English Agent Skill

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.

394 tokens
context cost
SKILL.md, read when the skill is used
1
files
instructions only
0
copies elsewhere
how many repositories repackaged it
100 959
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/paperclipai/paperclip --skill simplified-english

The instruction itself

3 sections, as written by the author

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")

How to use it

Copy the folder

Take paperclipai/simplified-english from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.