CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

59

Quality

69%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./packages/skills-catalog/catalog/optional/content/simplified-english/SKILL.md
SKILL.md
Quality
Evals
Security

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")
Repository
paperclipai/paperclip
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.