К основному содержанию
скилл CX Codex

writing-simplified-technical-english — скилл для Claude Code и Codex

Скилл writing-simplified-technical-english переписывает английский текст по стандарту ASD-STE100: одно значение на слово, активный залог, короткие предложения. Для отчётов, PR-описаний, промптов и сообщений об ошибках.

MIT 138 установок ★ 80 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add PostHog/skills --skill writing-simplified-technical-english -a claude-code
Открыть на GitHub

Что делает writing-simplified-technical-english

Скилл задаёт агенту правила письма по ASD-STE100 — стандарту контролируемого языка, который придумали для авиационных инструкций по техобслуживанию. Правила такие: один глагол на одно действие, активный залог, простые времена, одна мысль на предложение, до 20 слов в инструкции и до 25 в описании. Сокращать в ущерб смыслу нельзя. Если короткая фраза теряет условие или число, остаётся длинная.

Внутри таблица правил с парами «так / не так», порядок переписывания в четыре шага и список вопросов для самопроверки перед отправкой. Рядом два файла: references/writing-rules.md с подробностями и references/before-after.md с разборами. Сверху стиль PostHog, который главнее правил при расхождении: американский английский, sentence case, оксфордская запятая и никакого длинного тире.

Для маркетинговых текстов и постов скилл не подходит: STE намеренно плоский, а цитаты из логов или документов он велит оставлять как есть.

Какие задачи решает

  • переписать отчёт агента так, чтобы его нельзя было понять двояко
  • разбить длинное описание PR на предложения с одной инструкцией в каждом
  • свести сообщения об ошибках и пустые состояния к одному глаголу на действие
  • проверить промпт для другого агента на двусмысленные формулировки
  • убрать пассивный залог из пошаговой инструкции

Примеры запросов агенту

  • Перепиши этот отчёт по правилам simplified technical english: одна мысль на предложение.
  • Слишком плотно — упрости описание PR по ASD-STE100.
  • Проверь строки ошибок в errors.ts и перепиши их в STE.

Как установить writing-simplified-technical-english

1Через Skills CLI (Vercel)

npx skills add PostHog/skills --skill writing-simplified-technical-english -a claude-code

2Вручную: положить файлы

~/.claude/skills/writing-simplified-technical-english/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/writing-simplified-technical-english/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о writing-simplified-technical-english

Как установить writing-simplified-technical-english в Claude Code?

Выполните npx skills add PostHog/skills --skill writing-simplified-technical-english -a claude-code. Файл скилла появится по пути ~/.claude/skills/writing-simplified-technical-english/SKILL.md.

Что делает writing-simplified-technical-english?

Заставляет агента писать английский текст по правилам ASD-STE100: один смысл на слово, активный залог, простые времена, короткие предложения с одной мыслью. Работает и при переписывании готового текста.

Для каких текстов скилл не подходит?

Для маркетинга, блогов и всего, где важен голос автора. Цитаты из логов, писем или документов он не трогает.

Исходный текст

SKILL.md · MIT
---
name: writing-simplified-technical-english
description: 'Write English that a reader cannot misread: one meaning per word, active voice, simple tenses, one idea per sentence, short sentences. Based on ASD-STE100 (Simplified Technical English), the controlled-language standard written for aircraft maintenance manuals. Use it for any prose an agent produces that someone else acts on. That covers reports and findings, PR descriptions and commit messages, instructions handed to another agent, tool descriptions, error messages, status summaries, and prompts. Also use it on request, with triggers like "simplify this", "make this readable", "too dense", "rewrite in STE", "simplified technical english", "ASD-STE100".'
---

# Writing simplified technical English

ASD-STE100 is a controlled-language standard.
The aerospace and defense industry wrote it so that a technician cannot misread a maintenance instruction.
It removes the two biggest sources of misreading: words that carry more than one meaning, and sentences that support more than one structure.

The same discipline fixes the usual failure of agent-written prose.
Agent output is often correct and unreadable: long sentences, stacked hedges, passive voice, and a synonym rotation that makes one action look like three.
The reader has no author to ask, so ambiguity costs them a re-read at best and a wrong action at worst.

Apply the rules below as you write.
Do not write a dense draft and clean it up afterward.

## When to use this

Use it for text that a person or another agent must act on:

- Reports, findings, and summaries.
- PR descriptions, commit messages, and code comments.
- Instructions passed to another agent, and prompts.
- Tool descriptions, error messages, empty states, and log lines.

Do not use it where voice is the point: marketing copy, blog posts, or anything persuasive.
STE is deliberately flat.
Also leave quoted text alone.
If you quote a user, a log, or a document, quote it as it is.

## The rules

| Rule                        | Do                                                                   | Do not                                                      |
| --------------------------- | -------------------------------------------------------------------- | ----------------------------------------------------------- |
| One meaning per word        | Pick one verb per action and reuse it every time                     | Rotate "check", "verify", and "confirm" for the same action |
| One part of speech per word | "Apply oil to the valve"                                             | "Oil the valve"                                             |
| Active voice                | "The worker deletes the file."                                       | "The file is deleted."                                      |
| Simple tenses               | "We received the report."                                            | "We have received the report."                              |
| One idea per sentence       | "Open the file. Read line 3."                                        | "Open the file and read line 3, then check it matches."     |
| Sentence length             | 20 words or fewer for instructions, 25 or fewer for descriptions     | Chains of subordinate clauses                               |
| Noun clusters               | 3 words or fewer ("fuel pump valve")                                 | "high pressure fuel pump inlet valve assembly"              |
| No missing words            | Keep the subject, the verb, and the article, even if it reads longer | "Files not backed up will be lost", which hides which files |
| One hedge, at most          | "The client version is probably out of date."                        | "An error may have occurred which could be caused by..."    |
| Paragraphs                  | One topic, 6 sentences or fewer                                      | Multi-topic paragraphs                                      |
| Lists                       | Use a list for 3 or more steps or conditions                         | A sequence buried in one sentence                           |
| Jargon                      | Keep the technical term you need, and define it once                 | Use an internal name the reader has never seen              |

PostHog house style sits on top of these rules and wins where the two disagree.
We use American English, sentence case, and the Oxford comma.
We do not use the em-dash.

## How to rewrite

1. Read the text once for meaning. Do not start rewriting before you know what it must still say.
2. Go sentence by sentence. Name the rule each sentence breaks.
3. Rewrite the sentence to fix that break. Keep every fact, number, condition, and qualifier.
4. Check the result against the rules again. A rewrite often introduces a new long sentence.

Precision beats brevity.
If a shorter sentence would drop a safety condition, a scope qualifier, or a number, keep the longer sentence and say why.

If the text already follows the rules, say so.
Do not change compliant text.

## Self-check

Before you send the text, read it once and ask:

- Does any sentence run past 25 words?
- Does any sentence carry two instructions?
- Does the same action appear under two different verbs?
- Can a passive sentence name its actor?
- Would a reader who joins here, with no context, know what to do next?

## References

- `references/writing-rules.md`: the detail behind the table, plus sources.
- `references/before-after.md`: worked examples of the rewrite, including agent output.

© PostHog · MIT · PostHog/skills

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
technical-writing proffesor-for-testing Скилл technical-writing задаёт правила технического текста: вести с пользы, подтверждать примерами и числами, резать лишние слова. Включается при написании постов, документации и туториалов. CX Codex +1 209установок writing-user-docs callstackincubator Скилл writing-user-docs для Claude Code задаёт тон и структуру пользовательской документации. Помогает писать и править тексты для тех, кто работает с инструментом. CX Codex +1 1 500установок llm-writing haowjy Скилл llm-writing для Claude Code задаёт правила редактирования текстов перед сохранением в репозиторий. Очищает коммиты, PR, документацию и промпты от шаблонных фраз языковых моделей. CX Codex +1 815установок writing-clearly-and-concisely davila7 Скилл writing-clearly-and-concisely для Claude, который заставляет агента писать прозу по правилам Странка и не скатываться в шаблонные обороты языковых моделей. CX Codex +1 206установок writing-guidelines vercel Скилл writing-guidelines для ревью документации и прозы по письменному гайдлайну. Возвращает замечания с номерами строк, чтобы правки не искать по всему файлу вручную. CX Codex +1 133 400установок

Из того же набора112

Весь набор →
workload-analysis Скилл workload-analysis для Claude Code собирает данные об аккаунте PostHog и строит React-визуализацию расходов по продуктам, нагрузкам и командам. Показывает разбивку SDK, возможности роста и риски. CX Codex +1 203установок posthog-pls-transition-leads Скилл posthog-pls-transition-leads разбирает переходные лиды PostHog: клиентов startup-программы с истекающими кредитами и аккаунты с первым счётом от $2K. Возвращает решение, писать ли, и черновик письма. CX Codex +1 199установок account-handover Скилл account-handover собирает отчёт для передачи клиента между TAM или CSM на основе данных Vitally и аналитики PostHog. CX Codex +1 193установок feature-flags-nextjs Скилл feature-flags-nextjs добавляет фича-флаги PostHog в приложение на Next.js: проверки в компонентах, оценку на сервере и управление флагами из чата, если подключён PostHog MCP-сервер. CX Codex +1 140установок integration-javascript_node Скилл integration-javascript_node ставит PostHog в серверное Node.js-приложение через posthog-node: события в роутах, идентификация пользователей, отлов исключений. CX Codex +1 131установок integration-javascript_web Скилл integration-javascript_web помогает встроить клиентскую веб-аналитику PostHog на базе библиотеки posthog-js в браузерное приложение. CX Codex +1 125установок llm-analytics-setup Скилл llm-analytics-setup подключает LLM-аналитику PostHog к приложению на одном из поддерживаемых провайдеров: токены, задержка и стоимость каждого вызова. CX Codex +1 120установок experiment-audit Скилл experiment-audit для Claude Code проверяет настройку эксперимента PostHog, сбор данных по вариантам, атрибуцию и метрики. Запускается по просьбе проверить или провести аудит A/B-теста. CX Codex +1 118установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой