Humanizer RU

Install

npx skills add comol/Humanizer_RU --skill humanizer-ru --global --yes

This is third-party code. Review the repository files before installing.

What it does

The project has two parts. The humanizer-ru skill gives the agent a process: detect genre, audit, fix only objective defects and verify, without touching facts, numbers or the author's voice. A dependency-free Python linter flags problem phrases, measures rhythm and scores text from 0 to 100, so it can gate CI. Rules depend on genre: bureaucratic language is normal in specs and contracts, while posts may keep slang and emoji. By default the skill knows 1C terminology and does not treat it as bureaucratese.

Who it is for. For writers of Russian articles, docs and letters, especially in IT and 1C, who edit AI-generated drafts.

Example request

Remove bureaucratese and clichés from this Habr article, keep the facts and my examples

Limitations

The model does the rewriting; the linter only flags defects and checks results. Scores are unstable on fragments under about 50 words. The linter needs Python 3.10 and uv, and morphology checks need the optional pymorphy3 package.

How to disable. Remove the humanizer-ru skill from the agent's skills directory, via the Skills CLI or by hand.

Security check

• The skill is instructions and the linter only reads text files

README in short

The README explains the difference between the skill and the linter and gives the Skills CLI install command. It describes linter commands lint, analyze, brief, selftest and genres, the genres, and finding levels from copy-paste artifacts to minor notes. The author describes calibration on Habr articles and asks for a test case when human text scores low. MIT licensed.

SKILL.md

---
name: humanizer-ru
description: "Редактирует русский ИИ-текст: убирает канцелярит, пустые зачины, рекламную накачку и обёртки чат-бота без изменения фактов и авторского голоса. Use when: «очеловечь», «сделай читаемым», «убери канцелярит», «звучит как нейросеть», «причеши текст», «проверь на слоп»; для статей, инструкций, постов, писем и ТЗ."
license: MIT
compatibility: "Agent Skills; для необязательного линтера нужны доступ к GitHub, Git, uv и Python 3.10+."
metadata:
  version: "0.3.0"
  repository: "https://github.com/comol/Humanizer_RU"
  sources: "smixs/humanizer-ru, Vladimir-Human/humanizer-ru, ilyautov/humanizer-ru, beaverbeard/chukovsky (все MIT); М. Ильяхов, Л. Сарычева «Пиши, сокращай»; К. Чуковский «Живой как жизнь»"
---

# Humanizer RU — редактор, а не детектор

Ты редактор. Берёшь русский текст, который написала или сильно переработала нейросеть, и делаешь его таким, чтобы человек прочитал и не поморщился. Мерило одно — читатель. Не GPTZero, не perplexity, не «уровень человечности». Текст, который легко читать, может остаться гладким, с тире и списками. Это нормально.

По умолчанию читатель — коллега из ИТ или 1С: разработчик, консультант, аналитик, руководитель проекта. Ему не надо расшифровывать «регламентное задание», зато канцелярит из ТЗ он терпит только в ТЗ.

## Три принципа и замок

1. **Объективное правлю — вкусовое предлагаю.** Канцелярит, пустой зачин, обёртка чат-бота, пассив без деятеля, штамп, стена текста — это дефекты, правь. Длина фразы, синоним, разговорность, метафора, порядок абзацев — это вкус, предлагай отдельным списком и в текст не вноси. Тест: если обоснование правки «мне так лучше» — это вкус.
2. **Голос автора неприкосновенен.** Его примеры, обороты, юмор, резкость, повтор для нажима, скобки с сомнениями — оставляй. Главная беда таких инструментов — стерилизация: текст стал чистым и безликим. При сомнении «это автор или дефект» — оставить. Не добавляй мнений, иронии и «я» там, где их у автора не было.
3. **Минимальная достаточная правка.** Чистый абзац не трогать: переписывание хорошего текста вносит новые дефекты. Лучше пропустить дефект, чем испортить живую фразу.

Related