Simplified Technical Russian

Install

git clone https://github.com/loadkpi/simplified-technical-russian-skill ~/.claude/skills/simplified-technical-russian

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.

Example request

Simplify the Russian comments in this file and show the change table

Limitations

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.

Security check

• The linter runs as a Python script and reads project files
• The optional hook runs after every file write

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.

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 на техническую работу с кодом и
документацией. Читатель здесь другой: разработчик, переводчик, машинный
переводчик или другой ИИ-агент. Ошибка чтения стоит так же дорого, как в
инструкции по техническому обслуживанию.

## Проверка языка — до всего остального

**Сначала определите язык текста, который правите или пишете. Правила
применяйте только к русскому тексту.**

Язык запроса значения не имеет. Просьба «упрости этот комментарий», заданная
по-русски, относится к УТР только тогда, когда сам комментарий написан
по-русски.

## Режимы работы

| Режим | Когда включать | Что выдавать |
|---|---|---|
| **Письмо** | Просят написать русский текст | Только готовый текст. Без таблиц и пояснений |
| **Правка** | Дали текст и просят упростить или сократить | Исправленный текст, затем таблицу правок |
| **Аудит** | Просят проверить текст | Только таблицу нарушений. Текст не меняют |
| **Постоянный** | Просят применять правила ко всей сессии | Каждый русский ответ по правилам. Без таблиц |

Related