# Agents misread Hebrew. A 40-year-old aerospace standard helps.

> Source: <https://dev.to/galbe/agents-misread-hebrew-a-40-year-old-aerospace-standard-helps-370>
> Published: 2026-10-22 07:04:16+00:00

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](https://github.com/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](https://github.com/g4lb/asd-ste100-hebrew-skill)

If you write Hebrew for agents, tell me which rules feel wrong.