In aerospace maintenance, a misread instruction can ground an aircraft, or cause worse damage. So the industry built ASD-STE100, Simplified Technical English. It is a controlled language with one meaning per word, active voice, short sentences, and one instruction per sentence.
Today a new kind of reader parses technical text with no one to ask: the AI agent. A model reads tool descriptions, error messages, and instructions between agents. It cannot ask the author what the author meant. danyuchn/asd-ste100-skill applies STE100 to English agent text as a Claude Code skill. I ported it to Hebrew.
STE100 defines English only. No official Hebrew version exists, so every Hebrew rule here is an adaptation. Some English rules carry over directly. Others have no English equivalent:
ืืช.ืืฉืชืืฉ is both "user" and "uses". Keep it a noun and use a different verb: "ืืืฉืชืืฉ ืืคืขืื ืืช ืืืื".ืืืฆืข with an action noun.
Before:
ืืืชืื ืฉืืืจืขื ืฉืืืื ืืืืื ืขืืืื ืืืงืฉื ืฉืื ืขืงื ืื-ืืชืืื ืืคืฉืจืืช ืืคืืจืื ืื ืชืื ืื ืืฆืคืื, ืืฉืจ ืขืฉืืื ืืืืืจื ืืชืืฆืื ืืืจืกืช ืืงืื ืฉืืื ื ืืขืืืื ืช.
After:
ืืืชืื ืฉืืืจืขื ืฉืืืื ืืขืืืื ืืืงืฉื. ืืืชืื ืฉืืกืืื ืืื ืื-ืืชืืื ืืคืืจืื ืื ืชืื ืื ืืฆืคืื. ืืืชืื ืฉืืจืกืช ืืงืื ืื ืืขืืืื ืช ืืจืื ืืื-ืืืชืืื ืืื.
"ืืืจืขื ืฉืืืื" ("an error occurred") reads better. But it states an error that the system only suspects. A simplifier that removes uncertainty makes the text clearer and wrong. The skill splits the sentence into three claims and keeps every hedge.
A Python linter (scripts/ste-lint-he.py) uses only the standard library. It does a mechanical first pass: semicolons, sentence length, nominalization, marketing words, prefix hyphens, slang, and synonym rotation. It cannot check construct chains, homographs, or a dropped ืืช. The model and the author check those.
npx skills add g4lb/asd-ste100-hebrew-skill
Then ask Claude: ืคืฉื ืืช ืชืืืืจ ืืืื ืืื ("simplify this tool description").
Repository (MIT license): https://github.com/g4lb/asd-ste100-hebrew-skill
If you write Hebrew for agents, tell me which rules feel wrong.