Humanizer-UA

[ English ]

More skills: skills.sh/madeval

Український текст, який звучить як людина.

Скіл для агентів: редагує український текст, прибирає сліди ШІ, канцелярит, суржик, русизми й кальки. Зміст, факти й голос автора лишаються на місці.

github.com/MADEVAL/humanizer-ua · автор: Yevhen Leonidov

Мета

Мета скіла — живий і природний український текст.

Модель пише для найширшого читача. Людина пише для одного. Звідси й маркери: важливість замість факту, рівний ритм, декор, залишки чату.

Живий текст звучить як людина: у ньому чути конкретну думку, власний голос і ритм, що змінюється. Природний текст не має російського синтаксису, канцелярської обгортки й кальок, які видають машинний переклад.

Скіл не додає емоцій, жартів, оцінок чи фактів. Він прибирає те, що заважає тексту звучати по-людськи. Живість не дописують — її звільняють з-під обгортки.

Скіл не визначає авторство й не генерує текст заново: він редагує написане.

Що робить

• Знімає 30 жорстких заборон, 11 нормативних правил і працює з 80 маркерами у восьми групах.
• Тримає факт-замок: числа, дати, імена, цитати, умови й модальність не змінюються.
• Править точково: проблема в одному реченні не тягне переписування всього тексту.
• Враховує жанр: маркетинг, експертиза, діловий лист, новини, наука, документація, юридика, художній текст.
• Має сканер без залежностей: норма, стиль і структура окремими шкалами, 30 заборон, 11 нормативних правил, 33 маркери, метрики ритму.
• Не штрафує слабкий маркер, якщо в абзаці немає інших ознак.
• Перевіряє себе: тестовий корпус, рубрика, тести тригерів і CI-гейт.

Як це виглядає

Було:

У сучасному світі спільна робота над документами відіграє ключову роль. Варто зазначити, що даний інструмент являється комплексним рішенням, яке відкриває нові горизонти. Ми запустили спільні чернетки: двоє людей можуть редагувати документ одночасно, зміни видно одразу. Коментарі залишаються прив’язаними до речення.

Стало:

Ми запустили спільні чернетки. Двоє людей можуть редагувати документ одночасно, зміни видно одразу. Коментарі залишаються прив’язаними до речення.

Знято шість жорстких заборон. Нового факту не додано, решта тексту вціліла.

Аудит того самого тексту:

ЧИСТОТА: 52/100  [marketing] · рерайт
  норма:         75/100   (2 помилок)
  стиль:         32/100   (4 зауважень)
  структура:    100/100   (0 зауважень)
  факт-ризик:     0/100   (0 пунктів на перевірку)
  слів: 40
  покриття:      33 із 80 маркерів + 30 заборон

НОРМА (виправити обов'язково):
  ✖ HB05 «Являється» ×1 (рядок 1)
  ⚠ HB04 «Даний / дана / дане» ×1 (рядок 1)

ЖОРСТКІ ЗАБОРОНИ:
  ✖ HB01 «У сучасному світі» ×1 (рядок 1)
  ✖ HB02 «Варто зазначити» ×1 (рядок 1)
  ✖ HB06 «Відіграє роль» ×1 (рядок 1)
  ✖ HB08 «Нові горизонти» ×1 (рядок 1)

Сканер рахує спрацювання правил. Це не ймовірність ШІ й не вирок про авторство. Нормативна шкала має вето: текст із помилкою не стає «чистим», навіть якщо стиль ідеальний. Автоматично перевіряються 33 із 80 маркерів; решту агент проходить за каталогом очима, тому 100/100 — це «чисто за правилами сканера», а не повна гарантія.

Встановлення

git clone https://github.com/MADEVAL/humanizer-ua.git
cd humanizer-ua

Скіл лежить у skills/humanizer-ua/. Скопіюй папку туди, де агент шукає скіли:

# OpenCode, у межах проєкту
mkdir -p .opencode/skills
cp -r skills/humanizer-ua .opencode/skills/

# OpenCode і Cursor, спільний каталог
mkdir -p .agents/skills
cp -r skills/humanizer-ua .agents/skills/

# Claude Code
mkdir -p ~/.claude/skills
cp -r skills/humanizer-ua ~/.claude/skills/

# Codex
mkdir -p ~/.codex/skills
cp -r skills/humanizer-ua ~/.codex/skills/

Глобальні каталоги теж працюють: ~/.config/opencode/skills, ~/.cursor/skills, ~/.claude/skills, ~/.codex/skills.

Виклик

/humanizer-ua

[текст]

Або словами: «олюдни цей текст», «прибери сліди ШІ», «вичитай і прибери канцелярит», «зроби живішим, але нічого не додавай».

Режими

Сказав «не прав» — режим «Власна чернетка» вимкнено до кінця розмови.

Сканер

python3 skills/humanizer-ua/scripts/scan.py стаття.txt --genre marketing
python3 skills/humanizer-ua/scripts/scan.py стало.txt --before було.txt
python3 skills/humanizer-ua/scripts/scan.py стаття.txt --json
python3 skills/humanizer-ua/scripts/scan.py стаття.txt --min-score 60

Сканеру потрібен лише Python 3.9+. Без pip install, моделей і мережі. На Windows викликай python, а не python3.

Перевірки й утиліти

Як працює

0. Межі          → що можна чіпати, що ні
1. Діагностика   → сканер + читання цілком
2. Розмітка      → KEEP / CUT / TRIM / REPLACE / JOIN / SPLIT
3. Правка        → жорсткі заборони → A–H
4. Факт-замок    → числа, імена, умови, модальність
5. Свіжа вичитка → незалежне рев’ю
6. Повторний скан → два кола максимум
7. Видача        → текст, максимум два рядки службового

Головне правило: видаляй, не дописуй. Емоції, оцінки, жарти, образи й факти, яких немає в джерелі, не додаються.

Принципи

1. Видаляй, не дописуй. Маркер знімається видаленням обгортки або перебудовою з тих самих слів.
2. Факт сильніший за стиль. Втрачене число — провал, навіть якщо текст звучить краще.
3. Локальна правка. Не переписуй структуру, якщо проблема в одному реченні.
4. Жанр визначає межі. Те, що вада в блозі, може бути нормою в науці чи юридиці.
5. Одна ознака ще не маркер. Маркер — це щільність і автоматичність.
6. Не детектор. Скіл не обіцяє проходження ШІ-детекторів і не вставляє одруки.
7. Голос автора — частина змісту. Не вирівнюй живий текст під «ідеальний».

Архітектура

Humanizer-Ukraine/
├─ skills/humanizer-ua/
│  ├─ SKILL.md                 # процедура й маршрутизація
│  ├─ edit-log.md              # правила з живого відгуку
│  ├─ references/
│  │  ├─ catalog.md            # 80 маркерів, приклади
│  │  ├─ hard-bans.md          # 30 заборон, жанрові винятки
│  │  ├─ surzhyk.md            # русизми, кальки, керування
│  │  ├─ wordlist.md           # перегріті слова й кліше
│  │  ├─ typography.md         # лапки, апостроф, тире, числа
│  │  ├─ registers.md          # жанрова матриця
│  │  ├─ voice.md              # голос за зразками
│  │  ├─ review.md             # бриф для свіжої вичитки
│  │  ├─ audit.md              # формат аудиту
│  │  └─ scan.md               # CLI і ручний fallback
│  └─ scripts/
│     ├─ scan.py               # тонка CLI-обгортка
│     ├─ humanizer_ua/         # рушій
│     │  ├─ text.py            # читання, маскування, абзаци, мова
│     │  ├─ rules.py           # 30 заборон + 33 маркери
│     │  ├─ norm.py            # 11 нормативних правил
│     │  ├─ context.py         # словники-винятки й впевненість
│     │  ├─ markers.py         # зіставлення й слабкі сигнали
│     │  ├─ metrics.py         # ритм, структура, оформлення
│     │  ├─ facts.py           # факт-замок і реєстр
│     │  ├─ scoring.py         # три шкали, плотність, пороги
│     │  ├─ score.py           # звіт, формати
│     │  ├─ cli.py             # argparse
│     │  └─ version.py         # версія пакета
│     ├─ scan_gate.py          # CI-гейт по файлах
│     ├─ lint_skill.py         # лінт скіла
│     ├─ check_examples.py     # README ↔ сканер
│     ├─ install_smoke.py      # перевірка копії
│     ├─ self_scan.py          # перевірка власної прози
│     ├─ build_release_zip.py  # ZIP для Claude.ai
│     ├─ export_rules.py       # JSON для інтеграцій
│     ├─ bump_version.py       # синхронна версія
│     ├─ test_scan.py          # 32 тести CLI/фактів/шкал
│     └─ test_rules.py         # 30 тестів: покриття й калібрування
├─ dist/
│  └─ rules-ua.json            # JSON-експорт правил для інтеграцій
├─ eval/
│  ├─ corpus/ai/               # тексти з маркерами
│  ├─ corpus/human/            # природні тексти
│  ├─ cases.jsonl              # пари «було → стало»
│  ├─ rubric.md                # оцінювання
│  ├─ triggers.json            # покриття опису
│  ├─ run_eval.py
│  └─ run_triggers.py
├─ commands/                   # /humanize, /audit
├─ scripts/validate_package.py
├─ .github/workflows/ci.yml    # перевірки на push і PR
├─ .claude-plugin/
├─ .cursor-plugin/
└─ README.md

Eval

python3 eval/run_eval.py

Перевірка відповідає на три питання:

• чи отримують ШІ-тексти нижчий бал, ніж людські;
• чи зберігають тестові пари обов’язкові факти;
• чи не вважає факт-замок втраченим те, що мусить залишитися.

Корпус маленький: 3 ШІ-тексти, 2 людські, 10 тестових пар. Це регресійний тест, а не доказ якості на будь-якому тексті.

Межі

• Сканер евристичний: він не розуміє іронію, цитати й контекст.
• Бал не є ймовірністю ШІ.
• Корпус маленький і нерепрезентативний.
• Скіл не обіцяє проходження детекторів і не робить текст «непомітним».
• Живість не вимірюється балом. Її видно, коли читаєш уголос.

Ліцензія

MIT. Див. LICENSE.