humanizer-ru 3.19.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ilya Utov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,207 @@
+# humanizer-ru
+
+> [Русская версия: основная](README.md)
+
+Claude Code / Cowork plugin. Kills AI smell in Russian text. The English [humanizer](https://github.com/blader/humanizer) won't help here. Russian AI markers are their own beast: bureaucratic noun-chains (канцелярит), English-syntax calques, missing particles like "же" and "ведь" that make Russian sound alive.
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Version](https://img.shields.io/badge/version-3.19.0-blueviolet)](https://github.com/ilyautov/humanizer-ru/blob/main/CHANGELOG.md)
+[![Stars](https://img.shields.io/github/stars/ilyautov/humanizer-ru?style=social)](https://github.com/ilyautov/humanizer-ru/stargazers)
+[![skills.sh](https://skills.sh/b/ilyautov/humanizer-ru)](https://skills.sh/ilyautov/humanizer-ru/humanizer-ru)
+
+<p align="center">
+  <a href="https://humanizer-ru.aifrontier.tech/">
+    <img src="assets/social-preview.png" alt="humanizer-ru: removes AI tells from Russian text. 64 patterns, 21 hard bans, scanner included" width="720">
+  </a>
+</p>
+
+📖 **Docs & write-ups (RU):** [humanizer-ru.aifrontier.tech](https://humanizer-ru.aifrontier.tech/): do AI detectors work on Russian, the 64 markers, plagiarism vs AI detection.
+
+## What you get
+
+64 patterns across 14 categories: канцелярит, English calques, emotional sterility, persuasion tricks, information rhythm, hedging specifics, plus the 2025-2026 stylistic fingerprints (jagged-meditation single-word sentences, pseudo-Socratic Q-A chains, decorative emoji per list item, pseudo-therapeutic register) and the 2026 formulas (inanimate subject, Title Case headings, mid-sentence truncation, negation triad), plus a discourse layer (explicit final moral, portrait-style character introduction, emotion conveyed only through the body, seamless causal chains, strictly linear chronology, no direct reader address: narrative signals that survive stylistic rewriting, per StoryScope / COLM 2026). 21 hard-banned constructions that scream "GPT wrote this", including em-dashes (detectors count their frequency). A research-backed section on how detectors actually work (perplexity, burstiness, morphology) with verified numbers from DivEye, PIFE, AINL-Eval 2025 (every citation checked, see SOURCES.md). Five article formulas. Voice calibration. Quad-pass audit with a "Skeleton" pass that reads only the first lines of list items to catch templated openings.
+
+## Install
+
+Three deployment channels: upload to Claude.ai web UI, roll out across an organization, or install into local agents (Claude Code, Cowork, API).
+
+### 1. Claude.ai (Web UI)
+
+1. Download the packaged skill:
+   [humanizer-ru.zip](https://github.com/ilyautov/humanizer-ru/releases/latest/download/humanizer-ru.zip)
+2. Open Claude.ai → **Settings** → **Capabilities** → **Skills**.
+3. Click **Upload skill** and select the ZIP.
+
+Do not use `archive/refs/heads/main.zip`: the uploader expects the skill folder at the top level of the archive, and in the repo archive it sits inside `humanizer-ru-main/skills/humanizer-ru/`. To build the archive yourself, zip the skill folder itself:
+
+```bash
+git clone https://github.com/ilyautov/humanizer-ru.git
+cd humanizer-ru/skills
+zip -r ../../humanizer-ru.zip humanizer-ru -x '*/__pycache__/*'
+```
+
+### 2. Organizations (Enterprise & Team)
+
+Workspace admins can roll the skill out to the whole team via **Admin Console → Workspace Skills → Add skill**. Upload the same ZIP, no per-user installation needed.
+
+### 3. Claude Code, Cowork, API (local agents)
+
+**Plugin marketplace** (recommended):
+
+```
+/plugin marketplace add ilyautov/humanizer-ru
+/plugin install humanizer-ru@ilyautov-plugins
+```
+
+**skills.sh CLI** (universal across Claude agents):
+
+```bash
+npx skills add https://github.com/ilyautov/humanizer-ru/tree/main/skills/humanizer-ru
+```
+
+The CLI drops `SKILL.md` into `~/.claude/skills/humanizer-ru/` and registers the skill on [skills.sh](https://skills.sh/ilyautov/humanizer-ru/humanizer-ru). Point at the full skill-folder path: the short `ilyautov/humanizer-ru` form resolves to the repo root, which has no `SKILL.md` (removed in v3.14.2), so the install either fails or pulls in the whole repository.
+
+**API (`/v1/messages` and equivalents):** pass the skill via the `container.skills` parameter. See your client's docs.
+
+**Manual:**
+
+```bash
+git clone --depth 1 https://github.com/ilyautov/humanizer-ru /tmp/humanizer-ru
+mkdir -p ~/.claude/skills
+cp -r /tmp/humanizer-ru/skills/humanizer-ru ~/.claude/skills/
+```
+
+Copy the whole folder, not just SKILL.md: the skill ships with a deterministic
+scanner, `scripts/scan.py` (the machine half of Audit mode; needs
+`pip install razdel pymorphy3`, and the skill gracefully falls back to a manual
+audit without them).
+
+### Package install smoke
+
+Before a release, build the ZIP with the same script used by CI, then run the
+install smoke against that archive. The smoke check copies `skills/humanizer-ru`
+into a clean temporary skills directory, runs the scanner from the installed
+copy, and checks that the ZIP has no `.DS_Store`, `__pycache__`, or `*.pyc`
+files:
+
+```bash
+python3 scripts/build_release_zip.py --output dist/humanizer-ru.zip .
+python3 scripts/install_smoke.py . --zip dist/humanizer-ru.zip
+```
+
+Expected result:
+
+```text
+RESULT: PASS build-release-zip
+RESULT: PASS install-smoke
+```
+
+### 4. Codex CLI (OpenAI)
+
+Codex uses the same Agent Skills format, so no separate build is needed:
+
+```bash
+git clone --depth 1 https://github.com/ilyautov/humanizer-ru
+mkdir -p ~/.codex/skills
+cp -r humanizer-ru/skills/humanizer-ru ~/.codex/skills/
+```
+
+Or from inside Codex via `skill-installer` with the path
+`ilyautov/humanizer-ru/skills/humanizer-ru`. Restart Codex after installing;
+invoke with `$humanizer-ru` or let it auto-trigger. For a per-project install,
+put the same folder under `.codex/skills/` in your repository.
+
+### 5. Other agents (shared SKILL.md standard)
+
+The Agent Skills format is now cross-platform, so humanizer-ru runs beyond the packaged stacks. Officially packaged and verified: Claude Code, Codex CLI, Cursor, Gemini CLI, DeepSeek Harness. Other agents read the same `SKILL.md`, no separate build needed.
+
+| How it connects | Agents | What to do |
+|---|---|---|
+| Read `SKILL.md` natively | GitHub Copilot, Cline, Roo Code, Kilo Code, Goose, OpenCode, OpenWork, Kimi Code CLI, OpenClaw, OpenHuman, Hermes | Copy the `skills/humanizer-ru` folder into the agent's skills dir (e.g. `~/.hermes/skills/`, `~/.kimi/skills/`, `.agents/skills/`) |
+| Installer conversion | Windsurf, Trae, Junie | Install via their skill installer, pointing at `ilyautov/humanizer-ru` |
+| Manual paste | Zed, Aider, Continue.dev | Paste the `SKILL.md` body into the agent's rules or instructions file |
+
+Generic path for native readers: drop the skill folder into the directory the agent scans (usually `<project root>/.agents/skills/` or `~/.config/agents/skills/`) and restart it. Same activation triggers.
+
+> Several of these agents (OpenClaw, Kimi, Hermes) have public skill registries (ClawHub and similar). Listing there adds reach with no extra code: the format is shared.
+
+### 6. DeepSeek Harness (dsh)
+
+DeepSeek Harness reads the same Agent Skills format. Two ways to install.
+
+As a bundle, one command into the profile you use (`web`, `tui` or `headless`):
+
+```bash
+dsh plugin --profile web add github:ilyautov/humanizer-ru
+```
+
+The bundle is text only: `package.json` with a `dsh.bundle` field and `cordis.patch.yml`, which mounts the stock `dsh-skill-filesystem` provider on the package's `skills/` folder. No executable code, no build step. Verify without running a model: `dsh --profile web --dump-config` shows a `# == humanizer-ru` layer. Remove with `dsh plugin --profile web remove humanizer-ru`.
+
+As a copy into the user skill root:
+
+```bash
+cp -r humanizer-ru/skills/humanizer-ru ~/.agents/skills/
+```
+
+dsh scans `~/.agents/skills` and `~/.dsh/skills` on its own, no restart needed. It ignores the `allowed-tools` frontmatter key and resolves `references/` relative to the skill folder, so the catalog and the edit log open the same way as in Claude Code.
+
+## Modes
+
+- **Full rewrite** (default): all 64 patterns, voice calibration, quad-pass audit.
+- **Audit**: diagnosis only, returns detected patterns with priority A-D.
+- **Targeted fix**: works on a specific category only.
+
+## Usage
+
+Ask Claude in Russian:
+
+```
+Очеловечь этот текст: [paste text]
+Перепиши, звучит как робот: [paste text]
+```
+
+Triggers: "очеловечь", "убери следы нейросети", "сделай живым", "звучит искусственно", "перепиши как человек".
+
+## Before / After
+
+Before:
+> В современном мире искусственный интеллект играет всё более важную роль в различных сферах деятельности. Стоит отметить, что данная технология является мощным инструментом для оптимизации рабочих процессов.
+
+After:
+> За последний год я внедрил AI-инструменты в три проекта. Два ускорились вдвое. Третий развалился, потому что команда перестала проверять то, что выдаёт модель. AI работает, когда понимаешь его ограничения.
+
+Five hard bans triggered in two sentences. Typical.
+
+## Do AI detectors work on Russian?
+
+Short answer: poorly, and it matters.
+
+GPTZero, Originality.ai, ZeroGPT and most popular AI-text detectors are trained mostly on English. On Russian they are unreliable and fail both ways:
+
+- **False positives:** text written by a real human routinely gets flagged as "AI-generated". English perplexity thresholds aren't calibrated for Russian, and Russian's rich morphology inflates "unpredictability" on its own.
+- **False negatives:** careful AI text passes as human.
+
+Even the best Russian-specific detector (RuRoBERTa on the AINL-Eval 2025 benchmark) lands around 86% accuracy, and one verdict in seven is wrong. And detectors don't generalize across domains (verified, see [SOURCES.md](SOURCES.md)).
+
+**What this means for humanizing.** Chasing "detector bypass" on Russian means tuning text to an unreliable, moving target. So humanizer-ru optimizes genuine text quality (removing bureaucratic noun-chains, calques and clichés, restoring author voice and live rhythm) rather than gaming a classifier. Those are measurable language properties (see [`eval/`](eval/)) independent of how bad any given detector is. Perplexity and burstiness rise as a side effect, which is what detectors try (and often fail) to measure. We run detectors against real human Russian texts in the harness and publish the false-positive rate: [eval/RESULTS.md](eval/RESULTS.md).
+
+## Sources
+
+Patterns drawn from 15+ Russian-language sources (Habr, vc.ru, Gramota.ru, HSE stylometry research, Dialog Conference RuATD, TechInsider, Kokoc.com), verified academic papers (DivEye, PIFE, MASH, Antislop, AINL-Eval, RuATD, NeurIPS 2025), and the Wikipedia AI Cleanup Project. Every citation and figure is checked against primary sources; unverified ones were removed. Full provenance: [SOURCES.md](SOURCES.md).
+
+Changelog: [CHANGELOG.md](CHANGELOG.md). Metrics and eval harness: [`scripts/`](scripts/) and [`eval/`](eval/). Full Russian documentation: [README.md](README.md).
+
+## Author
+
+Ilya Utov. I write about AI and working with text on Telegram: [Under the Hood](https://t.me/gorilla_under_hood).
+
+## Contributors
+
+- **Filipp Zarubin** ([@zarubinphil](https://github.com/zarubinphil)): category N "Discourse layer", patterns 59-64 from StoryScope (COLM 2026). Signals that survive a style rewrite. Plus Russian numeral agreement in the release gate.
+- **iKonushok** ([@ikonushok](https://github.com/ikonushok)): install smoke for the installed surface and release ZIP packaging. It checks what actually reaches the user, not the folder in the repo.
+
+Full list, including bug reports that changed the code: [CONTRIBUTORS.md](CONTRIBUTORS.md). How to get on it: [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+MIT

package/README.md

@@ -0,0 +1,340 @@
+# humanizer-ru: очеловечить русский AI-текст для Claude Code, Cursor, Codex и других AI-агентов
+
+> Скилл для Claude. Убирает 64 признака нейросети в русском тексте: канцелярит, кальки, фингерпринты ChatGPT и Claude. Метит в то, что меряют GPTZero, DivEye, RuBERT: поднимает perplexity и burstiness. 21 жёстких банов, quad-pass аудит, калибровка под голос автора, eval-харнес с метриками до/после.
+
+> [English version](README.en.md)
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Версия](https://img.shields.io/badge/версия-3.19.0-blueviolet)](https://github.com/ilyautov/humanizer-ru/blob/main/CHANGELOG.md)
+[![Звёзды](https://img.shields.io/github/stars/ilyautov/humanizer-ru?style=social)](https://github.com/ilyautov/humanizer-ru/stargazers)
+[![skills.sh](https://skills.sh/b/ilyautov/humanizer-ru)](https://skills.sh/ilyautov/humanizer-ru/humanizer-ru)
+
+<p align="center">
+  <a href="https://humanizer-ru.aifrontier.tech/">
+    <img src="assets/social-preview.png" alt="humanizer-ru: убирает следы нейросети из русского текста. 64 признака, 21 запрет, сканер в комплекте" width="720">
+  </a>
+</p>
+
+> **Было:** «В современном мире данная технология является не просто инструментом, а стратегическим активом».
+> **Стало (факты автора):** «Инструмент экономит команде сорок минут в день. Попробуйте теперь его у людей забрать».
+>
+> Три жёстких бана в одном предложении. [Полный разбор с режимом аудита ниже](#до-и-после).
+
+📖 **Документация и разборы:** [humanizer-ru.aifrontier.tech](https://humanizer-ru.aifrontier.tech/): [работают ли AI-детекторы на русском](https://humanizer-ru.aifrontier.tech/ai-detektory-na-russkom.html), [64 признака AI-текста](https://humanizer-ru.aifrontier.tech/52-priznaka-ai-teksta.html), [антиплагиат и нейросеть](https://humanizer-ru.aifrontier.tech/antiplagiat-i-neyroset.html).
+
+## Зачем это нужно
+
+Английский [humanizer](https://github.com/blader/humanizer) для русского текста не работает. У русских AI-маркеров своя физика: канцелярит («осуществление внедрения»), кальки с английского синтаксиса («стоит отметить, что»), отсутствующие частицы («же», «ведь», «вот»), которыми живой русский дышит. С английскими паттернами это не пересекается вообще.
+
+Кроме того, в 2025-2026 Claude и GPT-4/5 научились имитировать «глубокомысленность»: короткими рублёными предложениями («Точно. Отдельно. Рефлексивно.»), псевдо-сократическими вопросами («Зачем? Потому что.») и псевдо-терапевтическим регистром («ты не ошибаешься, что так чувствуешь»). Это новый слой маркеров, которого нет ни в одном другом humanizer.
+
+## Что внутри
+
+**64 паттерна AI-генерации в 14 категориях:**
+
+- A. Контентные: пустые открытия, размытые авторитеты, формульные выводы
+- B. Языковые: канцелярит, кальки, «является», нагромождение причастий
+- C. Стилистические: длинные тире, навязчивые списки, болд
+- D. Коммуникативные: артефакты чатбота, заискивание, водянистость
+- E. Морфологические: падежные ошибки, деепричастия не к подлежащему
+- F. Тональные: эмоциональная стерильность (4 подтипа), нет иронии, нет метафор
+- G. Структурные: разорванные абзацы, narrative drift, галлюцинации
+- H. Человеческие мелочи: идеальная грамотность, вылизанная типографика
+- I. Паттерны убеждения: негативные параллелизмы, авторитетные трюизмы
+- J. Информационный ритм: равномерная плотность, гладкие переходы, macro-burstiness
+- K. Хеджирование и специфика: модальная неопределённость, translationese, нет идиом
+- L. Стилистические фингерпринты 2025-2026: рваная медитативность, контр-вопросы, эмодзи-декор, псевдо-терапия, пустой образ, самомаркировка честности
+- M. Формулы и артефакты 2026: неодушевлённый субъект, Title Case в заголовках, обрыв на полуслове, триада-отрицание
+- N. Дискурсный слой: явная мораль в финале, портретный ввод героя, эмоция только через тело, бесшовная причинность, линейная хронология, нет обращения к читателю. Признаки, которые переживают стилевую правку (StoryScope, COLM 2026)
+
+**21 жёстких банов**: конструкции с абсолютным запретом. От «В современном мире...» и «Стоит отметить, что...» до маркетинговых клише «Раскрыть потенциал», «Комплексный подход», «Открывает новые горизонты».
+
+**Quad-pass аудит**: четыре независимых прохода: Детектор (поиск маркеров), Человек с улицы (взгляд читателя), Кардиограмма (вариативность информационной плотности), Скелет (анализ первых строк пунктов списка на шаблонность).
+
+**Калибровка под голос автора.** Если дать образцы своего письма, скилл анализирует ритм, лексику, любимые обороты, пунктуацию, тон и применяет ваш стиль вместо средне-нейтрального.
+
+**Три режима работы:**
+- Полное редактирование (по умолчанию): все 64 паттерна
+- Аудит: только диагностика, текст не трогает
+- Точечная правка: работа с одной категорией
+
+**Что ловят детекторы:** секция с числами из исследований 2025-2026. DivEye: вторые производные surprisal дают 39.4% вклада в детекцию. Perplexity gap 29.5 vs 15.2 (человек vs LLM). AINL-Eval 2025: лучший результат на тесте около 86% (52K русских текстов, 12 доменов). Все ссылки и цифры верифицированы по первоисточникам, см. [SOURCES.md](SOURCES.md).
+
+## Установка
+
+Скилл разворачивается тремя путями: загрузкой в веб-интерфейс Claude.ai, централизованной раскаткой на команду или установкой в локальные агенты (Claude Code, Cowork, API).
+
+### 1. Claude.ai (веб-интерфейс)
+
+1. Скачайте готовый архив скилла:
+   [humanizer-ru.zip](https://github.com/ilyautov/humanizer-ru/releases/latest/download/humanizer-ru.zip)
+2. Откройте Claude.ai → **Settings** → **Capabilities** → **Skills**.
+3. Нажмите **Upload skill** и выберите скачанный архив.
+
+> Не берите `archive/refs/heads/main.zip`: загрузчик ожидает папку скилла в корне архива, а в архиве репозитория она лежит внутри `humanizer-ru-main/skills/humanizer-ru/`. Если нужно собрать архив самому, архивируйте именно папку скилла:
+>
+> ```bash
+> git clone https://github.com/ilyautov/humanizer-ru.git
+> cd humanizer-ru/skills
+> zip -r ../../humanizer-ru.zip humanizer-ru -x '*/__pycache__/*'
+> ```
+
+### 2. Организации (Enterprise и Team)
+
+Администраторы Claude for Work раскатывают скилл централизованно через workspace skill library, и он становится доступен всей команде без индивидуальной загрузки. Загрузите ZIP в **Admin Console → Workspace Skills → Add skill**.
+
+### 3. Claude Code, Cowork и API (локальные агенты)
+
+**Через плагин-маркетплейс** (рекомендуется):
+
+```
+/plugin marketplace add ilyautov/humanizer-ru
+/plugin install humanizer-ru@ilyautov-plugins
+```
+
+После установки плагин подгружает скилл автоматически при триггерах вроде «очеловечь», «убери канцелярит», «перепиши как человек».
+
+**Через skills.sh CLI** (универсальный путь для любого Claude-агента):
+
+```bash
+npx skills add https://github.com/ilyautov/humanizer-ru/tree/main/skills/humanizer-ru
+```
+
+CLI кладёт `SKILL.md` в `~/.claude/skills/humanizer-ru/` и регистрирует скилл в индексе [skills.sh](https://skills.sh/ilyautov/humanizer-ru/humanizer-ru). Указывайте полный путь к папке скилла: короткая форма `ilyautov/humanizer-ru` смотрит в корень репозитория, где `SKILL.md` нет (убран в v3.14.2), и установка либо падает, либо тащит весь репозиторий.
+
+**Через API (`/v1/messages` и аналоги):** передайте скилл параметром `container.skills`. Детали в документации вашего клиента.
+
+**Вручную** (если ничего из выше не подошло):
+
+```bash
+git clone --depth 1 https://github.com/ilyautov/humanizer-ru /tmp/humanizer-ru
+mkdir -p ~/.claude/skills
+cp -r /tmp/humanizer-ru/skills/humanizer-ru ~/.claude/skills/
+```
+
+Копируйте папку целиком, а не один SKILL.md: вместе со скиллом едет
+детерминированный сканер `scripts/scan.py` (машинная половина режима «Аудит»;
+работает при наличии `pip install razdel pymorphy3`, без них скилл просто
+проводит аудит вручную).
+
+### 4. Codex CLI (OpenAI)
+
+Codex использует тот же формат Agent Skills, отдельная версия не нужна:
+
+```bash
+git clone --depth 1 https://github.com/ilyautov/humanizer-ru
+mkdir -p ~/.codex/skills
+cp -r humanizer-ru/skills/humanizer-ru ~/.codex/skills/
+```
+
+Либо изнутри Codex через `skill-installer`: укажите путь
+`ilyautov/humanizer-ru/skills/humanizer-ru`. После установки перезапустите Codex;
+вызов: `$humanizer-ru` или автоматически по триггер-фразам («очеловечь»,
+«убери канцелярит»). Проектная установка: та же папка в `.codex/skills/` внутри репозитория.
+
+Или клонированием:
+
+```bash
+git clone https://github.com/ilyautov/humanizer-ru.git ~/.claude/skills/humanizer-ru
+```
+
+### Проверка установочного пакета
+
+Перед релизом соберите ZIP тем же скриптом, который использует CI, затем
+прогоните install-smoke по готовому архиву. Проверка копирует
+`skills/humanizer-ru` в чистую временную папку скиллов, запускает сканер из
+установленной копии и проверяет, что в ZIP нет `.DS_Store`, `__pycache__` и
+`*.pyc`:
+
+```bash
+python3 scripts/build_release_zip.py --output dist/humanizer-ru.zip .
+python3 scripts/install_smoke.py . --zip dist/humanizer-ru.zip
+```
+
+Ожидаемый результат:
+
+```text
+RESULT: PASS build-release-zip
+RESULT: PASS install-smoke
+```
+
+### 5. Другие агенты (общий стандарт SKILL.md)
+
+Формат Agent Skills стал кросс-платформенным, поэтому humanizer-ru работает и за пределами упакованных стеков. Официально упакованы и проверены: Claude Code, Codex CLI, Cursor, Gemini CLI, DeepSeek Harness. Остальные агенты читают тот же `SKILL.md`, отдельная версия не нужна.
+
+| Как подключается | Агенты | Что делать |
+|---|---|---|
+| Читают `SKILL.md` нативно | GitHub Copilot, Cline, Roo Code, Kilo Code, Goose, OpenCode, OpenWork, Kimi Code CLI, OpenClaw, OpenHuman, Hermes | Скопировать папку `skills/humanizer-ru` в каталог скиллов агента (например `~/.hermes/skills/`, `~/.kimi/skills/`, `.agents/skills/`) |
+| Конвертация инсталлером | Windsurf, Trae, Junie | Поставить через их установщик скиллов, указав репозиторий `ilyautov/humanizer-ru` |
+| Ручная вставка | Zed, Aider, Continue.dev | Вставить тело `SKILL.md` в файл правил или инструкций агента |
+
+Универсальный путь для нативных: положите папку скилла в каталог, который агент сканирует (обычно `<корень проекта>/.agents/skills/` или `~/.config/agents/skills/`), и перезапустите агент. Триггеры активации те же, что в Claude.
+
+> У части этих агентов (OpenClaw, Kimi, Hermes) есть публичные каналы дистрибуции скиллов (реестр ClawHub, tap-репозитории). Листинг там даёт охват без отдельного кода: формат общий.
+
+### 6. DeepSeek Harness (dsh)
+
+DeepSeek Harness читает тот же формат Agent Skills, и скилл ставится двумя способами.
+
+Бандлом, одной командой в нужный профиль (`web`, `tui` или `headless`):
+
+```bash
+dsh plugin --profile web add github:ilyautov/humanizer-ru
+```
+
+Бандл текстовый: `package.json` с полем `dsh.bundle` и `cordis.patch.yml`, который монтирует штатный провайдер `dsh-skill-filesystem` на папку `skills/` пакета. Исполняемого кода в бандле нет, сборка при установке не нужна. Проверить без запуска модели: `dsh --profile web --dump-config` покажет слой `# == humanizer-ru`. Удаление: `dsh plugin --profile web remove humanizer-ru`.
+
+Копией в пользовательский корень скиллов:
+
+```bash
+cp -r humanizer-ru/skills/humanizer-ru ~/.agents/skills/
+```
+
+dsh сканирует `~/.agents/skills` и `~/.dsh/skills` сам, перезапуск не нужен. Ключ `allowed-tools` из фронтматтера dsh не читает, а `references/` разрешает относительно папки скилла, так что каталог и журнал правок открываются как в Claude Code.
+
+## Использование
+
+Попросите Claude по-русски:
+
+```
+Очеловечь этот текст: [вставьте текст]
+Перепиши, звучит как робот: [вставьте текст]
+```
+
+Триггеры срабатывания: «очеловечь», «убери следы нейросети», «сделай живым», «звучит искусственно», «перепиши как человек», «убери канцелярит», «слишком формально».
+
+Режим аудита (только диагностика, без переписывания):
+
+```
+Проверь этот текст на AI-маркеры: [вставьте текст]
+```
+
+Точечная правка одной категории:
+
+```
+Убери канцелярит из текста: [вставьте текст]
+```
+
+При установке плагином в Claude Code доступны slash-команды:
+
+```
+/humanize <текст или путь к файлу>   # полный рерайт
+/audit <текст или путь к файлу>      # аудит без правки (сканер + разбор)
+```
+
+Сканер знает про жанр. По умолчанию он строгий, под маркетинг и блоги, а для
+других регистров снимает маркеры, которые там законны:
+
+```bash
+python skills/humanizer-ru/scripts/scan.py статья.txt --genre academic  # ещё legal, fiction
+```
+
+Зачем это нужно, показал прогон по внешнему размеченному корпусу AINL-Eval 2025
+(35 158 русских научных аннотаций): в строгом режиме баны оставались в 35,9%
+человеческих текстов против 26,1-35,8% машинных, то есть на научном тексте
+каталог не различал автора вовсе. С жанровой поправкой ложные срабатывания на
+людях падают до 4,2%. Цифры и метод: [eval/AINL-CALIBRATION.md](eval/AINL-CALIBRATION.md).
+
+## До и после
+
+**Полное редактирование:**
+
+До:
+> В современном мире искусственный интеллект играет всё более важную роль в различных сферах деятельности. Стоит отметить, что данная технология является мощным инструментом для оптимизации рабочих процессов.
+
+После:
+> За последний год я внедрил AI-инструменты в три проекта. Два ускорились вдвое. Третий развалился, потому что команда перестала проверять то, что выдаёт модель. AI работает, когда понимаешь его ограничения.
+
+Пять жёстких банов сработали в двух предложениях. Типичная картина.
+
+**Режим аудита на том же тексте выдаст:**
+
+```
+[A] Пустое открытие: "В современном мире..."
+[A] HARD BAN: "является мощным инструментом"
+[A] HARD BAN: "играет важную роль"
+[A] HARD BAN: "Стоит отметить, что..."
+[B] Канцелярит: "оптимизации рабочих процессов"
+[B] Раздувание: "всё более важную роль в различных сферах"
+```
+
+## Работают ли AI-детекторы на русском языке?
+
+Коротко: плохо, и это придётся учитывать.
+
+GPTZero, Originality.ai, ZeroGPT и другие популярные детекторы AI-текста обучены в основном на английском. На русском они ненадёжны и ошибаются в обе стороны:
+
+- **Ложные срабатывания (false positives):** текст, написанный живым человеком, регулярно помечается как «сгенерировано нейросетью». Английские пороги perplexity для русского не откалиброваны, а богатая русская морфология сама задирает «непредсказуемость».
+- **Пропуски (false negatives):** аккуратный AI-текст проходит как человеческий.
+
+Даже лучший специализированный русский детектор (RuRoBERTa на бенчмарке AINL-Eval 2025) даёт около 86% точности: каждый седьмой вердикт мимо. И детекторы не обобщаются между доменами: обученный на научных текстах ошибается на блогах (verified, см. [SOURCES.md](SOURCES.md)).
+
+**Что это значит для очеловечивания текста.** Гнаться за «обходом детектора» на русском значит подгонять текст под ненадёжный и постоянно меняющийся индикатор. Поэтому humanizer-ru оптимизирует не обман детектора, а **реальное качество текста**: убирает канцелярит, кальки и штампы, возвращает авторский голос и живой ритм. Это измеримые свойства языка (метрики в [`eval/`](eval/)), которые не зависят от того, насколько плох конкретный детектор. Заодно растут perplexity и burstiness: то, что детекторы (как умеют) и пытаются мерить.
+
+Мы прогоняем детекторы прямо в eval-харнесе по контролю «заведомо человек» (дословные отрывки статей Википедии, написанные людьми задолго до ChatGPT). В последнем прогоне локальный LLM-детектор пометил как ИИ **3 из 3** человеческих текстов (false positive rate 100%), поставив им ту же вероятность «это AI», что и настоящим AI-текстам. Различающая способность близка к нулю. Методика, корпус и сырые прогоны: [eval/RESULTS.md](eval/RESULTS.md), секция «FP-аудит детекторов».
+
+## Часто ищут
+
+**Как обойти GPTZero на русском?** GPTZero измеряет perplexity и burstiness. Скилл поднимает оба показателя: контрастное вычитание (замена самого предсказуемого слова в каждом предложении) повышает perplexity, рваный ритм с короткими и длинными предложениями повышает burstiness. Адверсарный парафраз снижает true positive rate детекторов на 87.88% по NeurIPS 2025.
+
+**Как убрать признаки ChatGPT из текста?** Главные сигналы: «не просто X, а Y» (80%+ AI-текстов), «стоит отметить», «является», длинное тире, отсутствие частиц «же/ведь/вот», равномерная информационная плотность. Скилл ловит и заменяет все 64 паттерна.
+
+**Как сделать текст ChatGPT человеческим на русском?** Три шага: убрать 21 жёстких банов, пройти контрастным вычитанием (одна замена на предложение), добавить речевые привычки (частицы, иронию, личное мнение, метафоры). Калибровка под голос автора усиливает эффект.
+
+**Что такое канцелярит и как его убрать?** Канцелярит: превращение глаголов в отглагольные существительные («осуществление внедрения» вместо «внедрили»). Главный маркер русских AI-текстов. Соотношение существительных к глаголам у AI 3:1, у людей 2:1. Скилл разворачивает номинализации обратно в глаголы.
+
+**Работает ли GPTZero на русском языке?** Ненадёжно. GPTZero обучен на английском и на русском даёт много ложных срабатываний: помечает живые человеческие тексты как ИИ, а аккуратный AI-текст пропускает. Подробнее в разделе «Работают ли AI-детекторы на русском».
+
+**Почему мой текст помечают как ИИ, хотя я писал его сам?** Частая беда на русском: детекторы, обученные на английском, принимают за «машинность» нормальные свойства русского текста (морфология, длинные слова, формальный регистр). Если текст реально ваш, это ложное срабатывание детектора, а не приговор. Скилл помогает убрать конкретные машинные маркеры (канцелярит, кальки, штампы), от которых текст звучит «нейросетево».
+
+**Какой AI-детектор лучший для русского?** Идеального нет. Из специализированных лучше показывают себя fine-tuned модели на базе RuRoBERTa (бенчмарк AINL-Eval 2025, ~86%), но и они проседают между доменами. Универсальные англоязычные (GPTZero, Originality, ZeroGPT) на русском особенно ненадёжны. Практический вывод: ориентируйтесь на реальное качество текста, а не на вердикт одного детектора.
+
+**Работает ли это с Claude Sonnet / Opus 4?** Да. Это инструкция-каталог для любой модели Claude. Чем больше контекст модели, тем глубже она применяет правила. На Opus результат заметно сильнее на длинных текстах.
+
+**Можно ли использовать без плагина?** Да. Скачайте SKILL.md и используйте как чек-лист для ручной правки или вставляйте в системный промпт любой LLM (ChatGPT, Gemini, YandexGPT, GigaChat).
+
+**А если мне нужно длинное тире (я редактор / формальная типографика)?** По умолчанию скилл вычищает все длинные тире «—»: это главный типографический маркер AI, и живой неформальный русский его почти не ставит (с телефона печатают дефис). Но если вам нужна правильная издательская типографика, прямо скажите об этом: «я профессиональный редактор, длинное тире оставляй». Скилл снимет запрет. Сам он это исключение не включает. Решаете вы.
+
+## Чем отличается от английского humanizer
+
+| | humanizer-ru | blader/humanizer |
+|---|---|---|
+| Язык | Русский | Английский |
+| Паттернов | 64 | 32 |
+| Жёстких банов | 20 | - |
+| Аудит | Quad-pass | Single-pass |
+| Voice calibration | Да | Да |
+| Стилистические фингерпринты 2025-2026 | Да | Нет |
+| Морфология RuBERT-детекторов | Да | - |
+| Macro-burstiness структурных блоков | Да | Нет |
+
+Английский humanizer ловит универсальные AI-маркеры. Русские требуют отдельной модели: канцелярит, кальки с английского синтаксиса, частицы «же/ведь/вот», падежные согласования RuBERT-детекторов, морфологические ошибки длинных цепочек, плюс свежие фингерпринты Claude и GPT 2025-2026 («рваная медитативность», эмодзи-декор, псевдо-терапия), которые в англоязычных каталогах ещё не оформлены.
+
+## Источники
+
+Скилл собран из четырёх независимых источников развития:
+
+- **Wikipedia: WikiProject AI Cleanup**: базовый каталог признаков AI-текста на русском
+- **15+ русскоязычных публикаций**: Habr, vc.ru, Gramota.ru, стилометрические исследования ВШЭ, Dialog Conference (RuATD-2022 и AINL-Eval 2025), TechInsider, Kokoc.com
+- **Верифицированные публикации (2024-2026)**: DivEye, PIFE, MASH, Antislop, AINL-Eval, RuATD, NeurIPS 2025 и др. Каждая ссылка и цифра проверена по arxiv и первоисточникам; неподтверждённые удалены. Полная таблица провенанса: [SOURCES.md](SOURCES.md).
+
+Changelog: [CHANGELOG.md](CHANGELOG.md). Метрики и eval-харнес: каталоги [`scripts/`](scripts/) и [`eval/`](eval/).
+
+## Автор
+
+Илья Утов. Пишу про AI и работу с текстом в Telegram: [Under the Hood](https://t.me/gorilla_under_hood).
+
+## Контрибьюторы
+
+- **Филипп Зарубин** ([@zarubinphil](https://github.com/zarubinphil)): категория N «Дискурсный слой», паттерны 59-64 по StoryScope (COLM 2026). Признаки, которые переживают стилевую правку. Плюс согласование падежа при счётчике в релизном гейте.
+- **iKonushok** ([@ikonushok](https://github.com/ikonushok)): install-smoke установочной поверхности и сборка релизного ZIP. Проверяется не папка в репозитории, а то, что реально доезжает до пользователя.
+
+Полный список, включая баг-репорты, которые изменили код: [CONTRIBUTORS.md](CONTRIBUTORS.md). Как попасть в него: [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Лицензия
+
+MIT: используйте свободно, форкайте, дорабатывайте. Pull request с новыми паттернами приветствуются.
+
+---
+
+**humanizer-ru** помогает очеловечить русский AI-текст: убрать следы нейросети, канцелярит и штампы, вернуть живой голос и сделать текст человечным. Это бесплатный open-source скилл для Claude (Claude Code, Cowork, API), а не онлайн-сервис «в один клик». Почему детекторы AI и проверка текста на нейросеть на русском ненадёжны (и при чём тут антиплагиат): в разделах выше, с реальными данными из нашего eval-харнеса, а не из обещаний.

package/cordis.patch.yml

@@ -0,0 +1,14 @@
+# Бандл для DeepSeek Harness. Ни строчки исполняемого кода: штатный провайдер
+# dsh-skill-filesystem монтируется отдельным экземпляром на папку skills/ этого
+# пакета, и скилл появляется в каталоге сессии. Путь вычисляется от места
+# установки пакета (pnpm положит его в профиль), поэтому бандл одинаково
+# работает из npm, из GitHub и из локального checkout.
+- insert:
+    - id: humanizer-ru-skills
+      name: '@deepseek-ai/dsh-skill-filesystem'
+      config:
+        providerName: humanizer-ru
+        includeDefaultRoots: false
+        watch: false
+        customSkillDirs:
+          - !!js "process.getBuiltinModule('node:path').join(process.getBuiltinModule('node:module').createRequire(baseUrl).resolve('humanizer-ru/package.json'), '..', 'skills')"

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "humanizer-ru",
+  "version": "3.19.0",
+  "description": "Agent skill for DeepSeek Harness: rewrites Russian text to remove 64 markers of AI generation (bureaucratese, calques, ChatGPT fingerprints), with a corpus-calibrated scanner, audit mode and author-voice calibration.",
+  "license": "MIT",
+  "author": "Ilya Utov",
+  "homepage": "https://humanizer-ru.aifrontier.tech/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ilyautov/humanizer-ru.git"
+  },
+  "keywords": ["dsh-bundle", "dsh-plugin", "agent-skill", "russian", "humanizer", "ai-text"],
+  "type": "module",
+  "files": ["cordis.patch.yml", "skills", "!skills/**/__pycache__"],
+  "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }
+}