ASD-STE100 Writer Skill
Скилл переписывает техтексты на упрощенный английский ASD-STE100: короткие фразы, активный залог, предупреждение перед шагом.
- 103 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Скилл не содержит полного словаря ASD, поэтому результат нельзя выдавать за сертифицированный текст.
Установка
- Работает в
В терминале, через 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, чтобы текст не мог прочитать неправильно другой аге
Скилл учит агента писать документацию и ответы простым английским по правилам ASD-STE100: короткие фразы, один термин, условие перед командой
Скилл переписывает китайский технический текст в контролируемый язык: одно действие на фразу, активный залог, один термин.
Simplified Technical English Skill
simplified-technical-english
Скилл заставляет модель писать на Simplified Technical English (ASD-STE100), контролируемом английском для технической документации. Неофициальный
Скилл убирает из текста защитные оговорки, извинения и лишние хеджи и делает формулировки прямыми, сохраняя нужные ограничения
Скилл превращает заметки инженеров, вводные заказчика и тестовые ожидания в четкие проверяемые технические требования.
Коротко о README
README показывает две пары «без скилла, со скиллом» и пример целого README до и после правки, затем перечисляет способы установки. Правила, чек-лист и список замен вынесены в отдельные файлы `references/`.