ASD-STE100 Writer Skill

Скилл переписывает техтексты на упрощенный английский ASD-STE100: короткие фразы, активный залог, предупреждение перед шагом.

  • 103 ★ репозитория
  • Последний коммит
Скилл

Минимальный доступ

Почему такой уровень

  • Скилл не содержит полного словаря ASD, поэтому результат нельзя выдавать за сертифицированный текст.
Все причины и проверки

blagoysimandov/asd-ste100-writer-skill

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/asd-ste100-writer-skill

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

  • Скилл не содержит полного словаря ASD, поэтому результат нельзя выдавать за сертифицированный текст.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл `ste100-writer` пишет и переписывает технические документы на упрощенном техническом английском ASD-STE100. Агент определяет тип текста (процедура или описание), применяет правила и сверяется с чек-листом. В процедуре предложение не длиннее 20 слов, в описании не длиннее 25, на одно предложение приходится одна инструкция, глаголы стоят в повелительном наклонении и активном залоге. Предупреждение ставится перед шагом, к которому относится. По запросу скилл показывает таблицу «было, стало». Полного словаря ASD в нем нет: есть только правила и небольшой список замен вроде `perform` на `do`. Если слова в списке нет, агент сообщает, что его нужно сверить с официальным словарем.

Для кого. Техническим писателям и инженерам, которые готовят инструкции и процедуры обслуживания на английском для читателей, у которых он не родной.

Подходит, если

  • Процедура обслуживания написана длинными предложениями и должна читаться по шагам.
  • README, сгенерированный нейросетью, переписывают без маркетинговых слов и с короткими фразами.
  • Предупреждения и предостережения в инструкции переносят перед шагами, к которым они относятся.
  • Текст идет на машинный перевод, и однозначные формулировки повышают его точность.

Не подходит, если

  • Текст нужно сертифицировать по полному словарю ASD: скилл словаря не содержит.
  • Документ написан не на английском: правила относятся только к английскому языку.
  • Маркетинговому или художественному тексту короткие однотипные фразы вредят.

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

Перепиши эту процедуру обслуживания по ASD-STE100, сохрани все технические данные и данные по безопасности.

Ограничения

Полного словаря ASD-STE100 в скилле нет: спецификация и словарь защищены авторским правом и доступны бесплатно на asd-ste100.org. Для слов вне списка агент только предупреждает о необходимости проверки и не выдает слово за одобренное. Результат не заменяет проверку по официальному словарю. В репозитории нет файла лицензии, поэтому условия использования не определены. Описаны только английские тексты: для других языков правила не подходят. Скилл рассчитан на технические инструкции и описания, а не на любой английский текст.

Как отключить. Удалите папку `ste100-writer` из каталога скиллов агента, например `~/.claude/skills/ste100-writer`.

Частые вопросы

Как проверить результат?

По `references/checklist.md`. В `evals/` есть простые оценки: три случая (процедура, описание, предупреждение), скрипт `run_eval.py` и список запрещенных слов.

Как поставить без npx?

Скопируйте `skills/ste100-writer` в каталог скиллов командой `cp -R asd-ste100-writer-skill/skills/ste100-writer ~/.claude/skills/ste100-writer` и перезапустите инструмент.

Что меняется в тексте?

Длинные предложения делятся, пассив уходит из инструкций, слова вроде `perform` и `obtain` заменяются на `do` и `get`.

Какие агенты поддержаны?

В README есть команды установки с флагом `-a` для GitHub Copilot, Claude Code и OpenCode.

Есть ли пример целого документа?

Да, `examples/ai-readme-before.md` и `examples/ai-readme-after.md` показывают README до и после правки.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл переписывает плотный и двусмысленный английский по правилам упрощенного технического языка ASD-STE100, чтобы текст не мог прочитать неправильно другой аге

СкиллМинимальный доступ6,4 тыс.Звезды репозитория

Скилл учит агента писать документацию и ответы простым английским по правилам ASD-STE100: короткие фразы, один термин, условие перед командой

СкиллРасширенный доступ4,4 тыс.Звезды репозитория

Скилл переписывает китайский технический текст в контролируемый язык: одно действие на фразу, активный залог, один термин.

СкиллМинимальный доступ97Звезды репозитория

Simplified Technical English Skill

simplified-technical-english

Скилл заставляет модель писать на Simplified Technical English (ASD-STE100), контролируемом английском для технической документации. Неофициальный

СкиллМинимальный доступ1 тыс.Звезды репозитория

Скилл убирает из текста защитные оговорки, извинения и лишние хеджи и делает формулировки прямыми, сохраняя нужные ограничения

СкиллМинимальный доступ1,9 тыс.Звезды репозитория

Скилл превращает заметки инженеров, вводные заказчика и тестовые ожидания в четкие проверяемые технические требования.

СкиллМинимальный доступ105Звезды репозитория

Коротко о README

README показывает две пары «без скилла, со скиллом» и пример целого README до и после правки, затем перечисляет способы установки. Правила, чек-лист и список замен вынесены в отдельные файлы `references/`.

Бейдж для README

Сообщить о проблеме