Упрощенный технический русский (УТР)
Скилл, который учит агента писать комментарии, документацию и сообщения об ошибках по правилам УТР из ГОСТ Р 58049-2017, плюс линтер
- 15 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Линтер запускается как Python-скрипт и читает файлы проекта
- Опциональный хук выполняется после каждой записи файла
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/uproschennyy-tehnicheskiy-russkiy-utrОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Линтер запускается как Python-скрипт и читает файлы проекта
- Опциональный хук выполняется после каждой записи файла
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл переносит на работу с кодом правила раздела 8.2 ГОСТ Р 58049-2017: короткие предложения до 20 слов, действительный залог, прямой порядок слов, один термин на одно понятие. Он работает в четырех режимах: пишет текст, правит с таблицей изменений, проверяет без правки и держит правила всю сессию. Правила применяются только к русскому тексту. В комплекте линтер на Python без зависимостей: 18 правил, режимы для документов и комментариев в коде, вывод в JSON, глоссарий проекта и хук PostToolUse для Claude Code.
Для кого. Для разработчиков и технических писателей, которым нужны однозначные русские комментарии, README и сообщения об ошибках.
Подходит, если
- Агент пишет русские комментарии и docstring канцеляритом
- Документацию будут переводить машинным переводчиком или читать другие агенты
- Нужно механически проверять русский текст при каждой записи файла
Не подходит, если
- Маркетинговые тексты, посты и художественный текст: стиль УТР намеренно сухой
- Текст не на русском
Пример запроса к агенту
Упрости комментарии в этом файле и покажи таблицу правокОграничения
Установка сама по себе не включает правила для всего текста: нужна строка в CLAUDE.md или хук. Линтер ищет признаки эвристиками, поэтому часть предупреждений о причастиях и страдательном залоге ложные. Соответствие ГОСТ скилл не сертифицирует. Нужен Python 3.7 и новее для линтера.
Как отключить. Удалите папку ~/.claude/skills/simplified-technical-russian, строки про УТР из CLAUDE.md и хук utr_lint.py из settings.json.
Частые вопросы
Почему папка без суффикса -skill?
Имя папки должно совпадать с полем name в SKILL.md, иначе агент не найдет скилл.
Хук остановит агента при нарушениях?
Нет. Хук возвращает модели список нарушений, и она исправляет текст сама.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ГОСТ — все инструментыСкилл вычитки русского текста: типографика, канцелярит и 17 признаков машинного текста, с правилом на каждую правку
Скилл сборки научной статьи по ГОСТу
scientific-article-builder
Скилл для агента Hermes, который ведет научную работу от источника до кликабельной ГОСТ-ссылки в DOCX и не дает выдумать цитату
Скилл для агентов, который собирает или проверяет документ по ГОСТ и выдает список замечаний со ссылкой на конкретный пункт стандарта
Семь скиллов редакционно-издательского оформления русского текста по справочнику Мильчина и Чельцовой
Скилл оформления студенческих работ по ГОСТ 7.32: агент пишет текст в Markdown, скрипт собирает .docx с титульным листом вуза
Скилл-редактор и линтер для русского текста после нейросети: канцелярит, пустые зачины, штампы и обертки чат-бота
Коротко о README
README объясняет, что такое УТР и почему агенту полезны его ограничения, и перечисляет файлы скилла: правила по пунктам ГОСТ, адаптацию к коду, словарь замен, чек-лист и примеры. Дана установка для Claude Code, Codex через AGENTS.md, Cursor, Windsurf и Cline. Отдельно описано, как включить правила постоянно через CLAUDE.md или принудительно через хук. Приведена таблица 18 правил линтера, способы подавления проверок и работа с глоссарием.
Бейдж для README
Исходный SKILL.md
--- name: simplified-technical-russian description: >- Упрощает и проясняет русский технический текст: одно значение на слово, действительный залог, прямой порядок слов, не более 20 слов в предложении (УТР, ГОСТ Р 58049—2017). Применяйте, только если упрощаемый или создаваемый текст написан по-русски; язык запроса значения не имеет. Триггеры: упрости, кратко, короче, проще, понятнее, простым языком, по УТР. К тексту на других языках не применяйте. license: MIT version: 1.1.0 --- # Упрощённый технический русский (УТР, ГОСТ Р 58049—2017) УТР — контролируемый технический язык: подвид естественного языка, полученный через систему ограничений лексики и грамматики. Цель ограничений — максимальная однозначность восприятия (пункт 3.14). Стандарт создан по образцу ASD-STE100 (Simplified Technical English) и вводит те же ограничения для русского языка. Навык переносит правила раздела 8.2 на техническую работу с кодом и документацией. Читатель здесь другой: разработчик, переводчик, машинный переводчик или другой ИИ-агент. Ошибка чтения стоит так же дорого, как в инструкции по техническому обслуживанию. ## Проверка языка — до всего остального **Сначала определите язык текста, который правите или пишете. Правила применяйте только к русскому тексту.** Язык запроса значения не имеет. Просьба «упрости этот комментарий», заданная по-русски, относится к УТР только тогда, когда сам комментарий написан по-русски. ## Режимы работы | Режим | Когда включать | Что выдавать | |---|---|---| | **Письмо** | Просят написать русский текст | Только готовый текст. Без таблиц и пояснений | | **Правка** | Дали текст и просят упростить или сократить | Исправленный текст, затем таблицу правок | | **Аудит** | Просят проверить текст | Только таблицу нарушений. Текст не меняют | | **Постоянный** | Просят применять правила ко всей сессии | Каждый русский ответ по правилам. Без таблиц |