Simplified Technical Russian skill
Упрощенный технический русский (УТР)
A skill that makes the agent write code comments, docs and error messages by the Simplified Technical Russian rules of GOST R 58049-2017, with a linter
- 15 ★ on the repository
- Last commit
Extended access
Why this level
- The linter runs as a Python script and reads project files
- The optional hook runs after every file write
Install
- Works in
- Services
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/uproschennyy-tehnicheskiy-russkiy-utrDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The linter runs as a Python script and reads project files
- The optional hook runs after every file write
This is third-party code. Review the repository files before installing.
What it does
The skill applies section 8.2 of GOST R 58049-2017 to code work: sentences up to 20 words, active voice, direct word order, one term per concept. It has four modes: write, edit with a change table, audit without edits, and keep the rules for the whole session. Rules apply only to Russian text. It ships a dependency-free Python linter with 18 rules, modes for documents and code comments, JSON output, a project glossary and a PostToolUse hook for Claude Code.
Who it is for. For developers and technical writers who need unambiguous Russian comments, READMEs and error messages.
Good fit when
- The agent writes bureaucratic Russian comments and docstrings
- Docs will go through machine translation or be parsed by other agents
- You want mechanical checks of Russian text on every file write
Not a fit when
- Marketing copy, posts or fiction: the style is deliberately dry
- The text is not Russian
Example request
Simplify the Russian comments in this file and show the change tableLimitations
Installing does not enforce the rules on all text: you need a CLAUDE.md line or the hook. The linter uses heuristics, so some participle and passive voice warnings are false positives. The skill does not certify GOST compliance. The linter needs Python 3.7 or newer.
How to disable. Delete ~/.claude/skills/simplified-technical-russian, the Simplified Technical Russian lines in CLAUDE.md and the utr_lint.py hook in settings.json.
FAQ
Why is the folder name without -skill?
The folder name must match name in SKILL.md, or the agent will not find the skill.
Does the hook block the agent on violations?
No. It returns the list of violations to the model, which then fixes the text.
Discussion
No questions or reviews yet.
Related
All GOST standards toolsRussian proofreading skill covering typography, bureaucratic style and 17 signs of machine text, with a rule cited for every fix
Scientific article builder with GOST citations
scientific-article-builder
A Hermes agent skill that carries a paper from source to a clickable GOST citation in DOCX, and never lets a citation be invented
gost-skills: GOST document formatting skill
gost-skills
An agent skill that assembles or reviews a document per GOST standards and lists every issue with a reference to the exact clause
Seven skills for Russian editorial and publishing style based on the Milchin and Cheltsova handbook
A skill for formatting Russian student papers to GOST 7.32: the agent writes Markdown, a script builds a .docx with the university title page
An editor skill and linter for Russian AI-written text: bureaucratese, empty openers, clichés and chatbot wrappers
README in short
The README explains Simplified Technical Russian and why its constraints help agents, then lists the skill files: rules by GOST clause, code adaptation, a replacement lexicon, a checklist and examples. It covers install for Claude Code, Codex via AGENTS.md, Cursor, Windsurf and Cline. It shows how to enforce the rules through CLAUDE.md or a hook. It includes the table of 18 linter rules, suppression markers and glossary use.
README badge
Original 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 на техническую работу с кодом и документацией. Читатель здесь другой: разработчик, переводчик, машинный переводчик или другой ИИ-агент. Ошибка чтения стоит так же дорого, как в инструкции по техническому обслуживанию. ## Проверка языка — до всего остального **Сначала определите язык текста, который правите или пишете. Правила применяйте только к русскому тексту.** Язык запроса значения не имеет. Просьба «упрости этот комментарий», заданная по-русски, относится к УТР только тогда, когда сам комментарий написан по-русски. ## Режимы работы | Режим | Когда включать | Что выдавать | |---|---|---| | **Письмо** | Просят написать русский текст | Только готовый текст. Без таблиц и пояснений | | **Правка** | Дали текст и просят упростить или сократить | Исправленный текст, затем таблицу правок | | **Аудит** | Просят проверить текст | Только таблицу нарушений. Текст не меняют | | **Постоянный** | Просят применять правила ко всей сессии | Каждый русский ответ по правилам. Без таблиц |