Agent-skill tvinger KI-verktøy til å skrive dokumentasjon på forenklet teknisk engelsk

Luftfartsindustrien har siden 1983 skrevet vedlikeholdsmanualer i ASD-STE100, forenklet teknisk engelsk. Maks 20 ord per instruksjon, ett ord med én betydning gjennom hele dokumentet, aktiv form, én instruksjon per setning og forbud mot «should», «would» og «may». Regelverket finnes fordi en trøtt mekaniker klokka to om natta ikke skal kunne mistolke en setning.

Utvikleren bak GitHub-repoet AminBlg/SimpleEnglish har pakket 53 av reglene inn i en agent-skill som følger Agent Skills-standarden, altså samme mappeformat som Claude Code, Cursor, Codex, Gemini CLI og rundt 25 andre verktøy leser. Repoet ble publisert 21. juli, ligger under MIT-lisens uten avhengigheter og installeres med npx skills add AminBlg/SimpleEnglish. Mangler verktøyet ditt skill-støtte, finnes reglene som systemprompt, også i en versjon på rundt 60 tokens.

Målingen er repoets egen: 6 Claude-modeller, 8 skriveoppgaver, 2 betingelser og 96 kjøringer, scoret av en deterministisk regex-linter med samme regler i begge betingelser. Snittet er 72,9 prosent færre STE-brudd per 100 ord med skillen på, og alle seks modellene brukte færre output-tokens. Gjennomsnittlig setningslengde falt fra 11,2 til 9,7 ord.

Den mest interessante bruken er ikke README-en din, men AGENTS.md-filene og systempromptene dine. En systemprompt er en prosedyre for en leser som ikke kan stille spørsmål, og modeller behandler «should» som valgfritt. STE forbyr ordet og krever betingelse før kommando. Repoet er ærlig om grensene: skillen nekter markedsføringstekst og bloggstemme, og ingen verktøy kan gi sertifisert STE fordi bransjeorganisasjonen ASD ikke sertifiserer verktøy.

Hva bør du gjøre?

1. Kjør skillen over AGENTS.md eller systempromptene dine først. Bytt ut hver «should» med «must» eller «can», og flytt betingelsen foran kommandoen.
2. Bruk den på feilmeldinger og runbooks, ikke på blogginnlegg. Repoet leverer egne tilpasninger for feilmeldinger, hendelsesrapporter og release notes.
3. Verifiser tallene selv med python3 evals/run_bench.py hvis du vurderer å standardisere på skillen. Benchmarken krever bare en innlogget Claude Code-CLI.