Repository avatar
Other Tools
v3.36.4
active

humanizer-ru

io.github.Vladimir-Human/humanizer-ru

Гигиена вставки из чата для русского текста: детерминированно, офлайн, флаги с причиной и советом.

Documentation

humanizer-ru

Навык для Claude Code, Codex, Cursor, Gemini CLI и Claude.ai. Правит русский текст после нейросети: убирает канцелярит, штампы и оформление «как у ChatGPT» и следит, чтобы цифры, даты, имена и оговорки остались прежними.

English · Сайт со сравнением

npx skills add Vladimir-Human/humanizer-ru

Пример

Пост для телеграм-канала пекарни, который написала нейросеть:

Вот готовый вариант поста для Telegram-канала. Он структурирован так, чтобы клиенты сразу увидели главную информацию.


🥐 Важные новости для гостей «Колоса» на Садовой!

Друзья, наша главная помощница — печь на Садовой, 14 — требует заботы и небольшого ремонта. Поэтому с понедельника, 2 ноября, мы временно закрываем эту точку примерно на две недели.

Если подрядчики справятся быстрее, мы с радостью откроемся раньше! Обязательно сообщим вам об этом здесь.

Как мы работаем в это время:

🎂 Предзаказы на торты. Все ноябрьские заказы в силе! Мы бережно испечем ваши торты и будем выдавать их в нашей пекарне на ул. Пушкина, 3 (ежедневно с 10:00 до 19:00).

🍞 Хлеб на развес. К сожалению, во время ремонта мы не сможем продавать весовой хлеб. Но как только печь снова заработает, сразу вернем его на витрины.

Приносим извинения за временные неудобства и очень ждем вас в гости на Пушкина, 3 за свежей выпечкой и горячим кофе! ☕️

Ваш «Колос» 🌾

После «очеловечь»:

Новости для гостей «Колоса» на Садовой

Друзья, печи на Садовой, 14 нужен небольшой ремонт. С понедельника, 2 ноября, мы временно закрываем эту точку примерно на две недели. Если подрядчики справятся быстрее, откроемся раньше и сообщим об этом здесь.

Пока идёт ремонт:

Торты по предзаказу. Все ноябрьские заказы в силе. Испечём их и будем выдавать в пекарне на ул. Пушкина, 3, ежедневно с 10:00 до 19:00.

Хлеб на развес. Пока печь на ремонте, весовой хлеб продавать не сможем. Как только она заработает, вернём его на витрины.

Извините за неудобства. Ждём вас на Пушкина, 3 за свежей выпечкой и горячим кофе.

Ваш «Колос»

Это ответ навыка из сравнения ниже (текст n01, исполнитель Claude Sonnet 5.5), руками в нём ничего не правили.

Установка

Любой агент с поддержкой Agent Skills (Claude Code, Codex, Cursor, Gemini CLI и другие):

npx skills add Vladimir-Human/humanizer-ru

В Claude Code можно поставить плагином, тогда обновления приходят через /plugin:

/plugin marketplace add Vladimir-Human/humanizer-ru
/plugin install humanizer-ru@humanizer-ru

Для каталога плагинов Claude плагин собран под именем humanizer-russian; навык везде называется humanizer-ru.

В Gemini CLI как расширение:

gemini extensions install https://github.com/Vladimir-Human/humanizer-ru

В Cursor, кроме npx skills add, можно взять репозиторий целиком как плагин (манифест .cursor-plugin/plugin.json): Cursor подхватывает плагины из ~/.cursor/plugins/local/ без установки.

git clone https://github.com/Vladimir-Human/humanizer-ru ~/.cursor/plugins/local/humanizer-ru

В Claude.ai скачайте humanizer-ru-skill.zip из последнего релиза и загрузите в Settings → Capabilities → Skills.

Вручную: скопируйте папку skills/humanizer-ru в ~/.claude/skills/ или ~/.agents/skills/.

Без установки

  • Проверка стиля в браузере: вставьте текст и посмотрите, какие приёмы машинного стиля в нём есть и где. Страница работает без сети, текст никуда не уходит. Она оценивает стиль, а не авторство: у живого текста тоже бывают баллы.
  • Промпт: сжатая версия навыка для модели, которая не умеет подключать навыки (системная подсказка, инструкции проекта).
  • Сверка фактов в браузере: вставьте исходник и правку любой модели, и страница сверит их так же, как check_facts.py: потерянные, перепутанные и новые числа, даты и имена видны сразу. Тексты никуда не уходят.

Как пользоваться

Вставьте текст и напишите «очеловечь». Другие просьбы:

  • «проверь, что выдаёт ИИ, но не правь» — список мест с объяснением, текст не меняется;
  • «убери только канцелярит» (только тире, только жирный) — правится один слой;
  • «поправь README.md» — правится проза, код и ссылки остаются как были;
  • образец своего текста и просьба — правка в вашей манере.

Хороший текст человека, договор или закон навык почти не трогает и говорит об этом.

Сравнение с другими навыками

Навыков, которые обещают то же самое, на GitHub больше двадцати. Мы сравниваем их на русских текстах вслепую: одна модель (Claude Sonnet 5.5) применяет каждый навык, три модели других лабораторий (Gemini 4 Argon, Kimi K3, Muse Spark 1.3) ранжируют перемешанные варианты по вопросу «что бы вы отправили с наименьшей доработкой» и выписывают ошибки смысла. У каждого судьи один голос, ошибка засчитана, если её отметили двое из трёх. Пороги записаны до того, как появились тексты.

Последний замер, 4.1.1: 24 свежих ИИ-текста одиннадцати моделей, которых навык не видел, и шесть человеческих текстов-ловушек.

УчастникЗвёзды на 05.11.2026Среднее место из 5humanizer-ru вышеТексты с ошибкой смысла из 24
humanizer-ru 4.1.11402.38—2
ilyautov/humanizer-ru5213.1065%2
avoid-ai-writing-russian273.1869%9
просьба одной строкой—3.7477%8

Пятым участником был новый вариант нашей инструкции из трёх циклов настройки. Прошлую инструкцию он не обогнал (49% сравнений, ошибок столько же), поэтому в 4.1.1 его нет. Gemini и Kimi ставят humanizer-ru выше обоих соперников, Muse Spark — выше avoid-ai-writing-russian и вровень с ilyautov. Две наши ошибки: «влияет на сохранность» стало «под угрозой сохранность», из благодарности инспектору выпала «вежливость». Шесть ловушек навык не испортил, простая просьба испортила три.

Насколько это не случайность. Бутстрэп по текстам (report.py, с 4.1.7) даёт 95% интервал: выше ilyautov 52–78%, выше avoid-ai-writing-russian 58–81%, выше простой просьбы 67–85%; все три разницы выходят за шум. Зато варианты нашей же инструкции, которые не вошли в релизы (49%, 42%, 46% сравнений), от 4.1.1 этот замер отличить не может: интервалы включают 50%. Версии 4.1.2–4.1.7 правили только скрипты; инструкцию 4.2.0 проверяли новой линейкой (ниже).

Замер 4.2.0, 09–10.11.2026. Главные мерки детерминированные: пробы с проверкой скриптом, сверка фактов, сходство с человеческим текстом. Денег замер не тратил. Подробности и все ответы: eval/README.md.

  • С терминалом (субагенты Claude Sonnet 5.5, 12 новых ИИ-текстов; черновик 4.2.0, две последние правки инструкции шаг сверки не трогали): навык сверил факты скриптом и закончил заметки строкой «Сверка скриптом: …» в 12 ответах из 12, её числа совпали со скриптом во всех 12. Фактов не потерял ни 4.2.0, ни 4.1.7, ни простая просьба; просьба оставила в одном тексте хвост utm_source=chatgpt.com.
  • 60 проб по 15 правилам (MiniMax M3.1 Flash без терминала, два прогона): 4.2.0 — 109 из 120 (черновик — 112), 4.1.7 — 108, просьба одной строкой — 79. Обращение на «вы» 4.2.0 теряет чаще: в перемере по шесть прогонов 3 провала из 48 против 1 из 48 у 4.1.7, разница не значима (p = 0,31). Просьба усиливает осторожные утверждения, оставляет обёртку чат-бота и переписывает юридический текст.
  • «Сделай живее» к шаблонному тексту: 4.2.0 правит без выдумок и задаёт автору вопросы в 12 случаях из 12, 4.1.7 не спрашивает.
  • 39 человеческих текстов, которые хорошему редактору почти не нужно трогать: сходство правки с исходником 0,87 у 4.2.0 против 0,85 у 4.1.7, текстов с ошибкой сверки 3 против 6. Из шести ловушек 4.2.0 ошибся в одной: в отрывке Герцена снял номера сносок.
  • Правка по образцу текста автора («голос») порог не прошла (ближе к автору в 7 случаях из 12, нужно 10), в 4.2.0 её нет. Перевес по стилю над простой просьбой этот замер не мерил.

Свежий сокращённый замер 21.10.2026 (final4): 12 новых текстов GPT-6.1 Sol и Gemini 4 Argon, исполнитель Sonnet 5.5, места расставляли Gemini 4 Argon и Claude Opus 5.5. humanizer-ru 4.1.1 первый из трёх и выше ilyautov/humanizer-ru v3.32.0 в 83% сравнений; ошибок смысла судьи не нашли ни у кого. Вариант с новыми признаками из Википедии уступил 4.1.1 (42% сравнений) и в релиз не вошёл.

В замере 4.1.0 участников было восемь: blader/humanizer (57 тыс. звёзд) там седьмой и ошибается чаще всех, stop-slop, no-ai-slop и avoid-ai-writing не прошли отбор. Все тексты, ответы, оценки и как повторить: eval/. Судьи здесь модели, живых редакторов среди них не было.

Скрипты

В папке навыка скрипты без зависимостей. Агент с терминалом запускает их сам, можно и вручную:

python skills/humanizer-ru/scripts/check_facts.py до.txt после.txt
python skills/humanizer-ru/scripts/clean_paste.py текст.txt --in-place
python skills/humanizer-ru/scripts/lint_style.py текст.txt

check_facts.py сравнивает исходник с правкой и показывает пропавшие или новые числа, даты, имена и ссылки, перевёрнутые отрицания, перепутанные суммы, ослабленные или усиленные утверждения и потерянные HTML-теги. В конце отчёта он печатает строку «Сверка скриптом: …»: сколько фактов на месте или каких значений нет в правке; навык переносит её в заметки дословно. Значения из служебных строк чат-бота вокруг текста («Готово, вот текст: ≈630 знаков», «Если хотите, могу…») скрипт ошибками не считает и называет отдельно. clean_paste.py снимает следы вставки из чата: contentReference, 【N†source】, хвосты utm_source=chatgpt.com и utm_source=openai, невидимые символы. Метки самого автора (utm_campaign в рассылке и т. п.) остаются, а их пропажу check_facts.py считает потерей ссылки. lint_style.py находит признаки из таблицы навыка и считает тире, жирный, эмодзи и заголовки на объём текста; цитаты в кавычках и блоки кода не трогает. Правила лежат в scripts/rules.json, их же читает страница проверки. Ключ --json отдаёт отчёт для программ.

Скрипты работают только с файлами, которые им передали, не ходят в сеть и не запускают другие программы. clean_paste.py меняет файл лишь с ключом --in-place и только если нашёл мусор вставки; перед этим он кладёт рядом копию оригинала с добавкой .bak к имени. Нужен Python 3.8 или новее.

Данные и приватность

Плагин ничего не собирает и не отправляет и своих данных не хранит: в нём нет серверов MCP, хуков и сетевых вызовов. Текст, который вы вставляете, обрабатывает Claude, как любое сообщение в чате. Агент с терминалом сохраняет исходник и правку во временные файлы вне вашего проекта, запускает check_facts.py и удаляет их. Больше скрипты ничего не пишут: только очищенный файл и его копию .bak.

Если что-то не работает

  • Навык молчит: напишите прямо «очеловечь» и вставьте текст или назовите навык humanizer-ru.
  • python не найден: на Windows попробуйте py. Без Python навык работает, факты агент сверит сам.
  • Сверка фактов показала ошибку, которой нет: это дефект скрипта, пришлите пример в Issues.
  • Claude.ai не принимает файл: загружайте humanizer-ru-skill.zip из релиза как есть, не распаковывая.

Детекторы ИИ

Навык правит текст для читателя. Проходит ли текст после него детекторы, мы не проверяли и не обещаем. Что о детекторах известно (проверено 21.10.2026):

  • Результат зависит от версии детектора. Антиплагиат с 25.09.2026 пишет в отчёте версию модели, чтобы было видно, почему две проверки одного текста разошлись (новость).
  • Детекторы ошибаются на коротких текстах и на канцелярите. Text.ru в справке называет тексты короче 1000 знаков и тексты, написанные канцелярским языком или полные штампов (детектор Text.ru).
  • Детекторы, обученные на русских текстах, на своём корпусе почти не ошибаются: в исследовании LLMTrace у дообученных моделей F1 0.97–0.99, а у детектора без обучения Binoculars на русском 0.02 (arXiv 2509.21269).
  • Русская Википедия советует не доверять детекторам и напоминает, что признаки ИИ в тексте не доказывают авторство (ВП:ПРГЕН).

Версия 3

Прошлая версия с исследованиями, пакетом PyPI и MCP-сервером лежит в ветке legacy-v3 и теге v3.36.4. Пакет на PyPI и запись в реестре MCP остались на 3.36.4: pip install humanizer-ru ставит сервер версии 3, а не навык.

Лицензия

MIT

PYPI
humanizer-ru
Install Command
pip install humanizer-ru
Runtime: uvx