Пиши нормально помогает AI-агентам писать и редактировать по-русски без машинной манеры. Скилл сохраняет факты, смысловые связи и голос автора, убирает нейрослоп, канцелярит, кальки, декоративную пунктуацию и шаблонный маркетинг.
Скачать готовый pishi-normalno.zip
Он не имитирует человека ошибками и не оптимизирует текст под AI-детекторы. Его задача проще и сложнее одновременно: получить хороший русский текст.
Плохая механическая правка:
Аккуратный промпт. Трата твоего времени.
Пиши нормально замечает, что точка разорвала одну мысль на две подписи, и возвращает сказуемое:
Аккуратный промпт отнимает у тебя время.
Скилл не заменяет запрещенный знак другим символом. Он сначала определяет связь между частями: оценку, причину, следствие, условие, противопоставление, пояснение или последовательность.
- Пишет с нуля, редактирует, усиливает и проверяет русский текст.
- Автоматически подключается к постам, Telegram, Threads, SMM, маркетингу, лендингам, письмам, статьям, кейсам, сценариям, CTA и UI-текстам.
- Сохраняет числа, имена, ссылки, цитаты, отрицания, условия, модальность и причинность.
- Сравнивает исходник с результатом и ловит добавленные выгоды, гарантии, причинность, обращение и разорванные связи.
- Защищает авторские слова, полезную шероховатость и силу исходного хука.
- Различает разговорный, социальный, маркетинговый, технический, научный, официальный и юридический регистры.
- Проверяет код, URL и цитаты отдельно от пользовательской прозы.
- Убирает длинные тире, стрелки, emoji, скрытые Unicode-символы и служебные следы генераторов.
- Не навязывает AIDA, PAS, триады, вопросы в финале, сленг, метафоры или искусственно рваный ритм.
Внутри находятся 33 составных редакторских паттерна, 21 машиночитаемая группа правил и детерминированный source-aware аудитор.
Выберите свою программу. Все ссылки ведут на готовые файлы релиза.
| Программа | Самый простой способ |
|---|---|
| Claude в браузере | Скачать ZIP, открыть Customize > Skills, загрузить скачанный файл |
| Claude Desktop | Скачать ZIP, открыть Customize > Skills, загрузить скачанный файл |
| Claude Code | Запустить одну команду для папки ~/.claude/skills |
| ChatGPT с Workspace Agents | Скачать ZIP и нажать Add skill |
| Обычный ChatGPT | Скачать MD и добавить его в Project |
| Codex app, CLI или IDE | Запустить одну команду для папки ~/.agents/skills |
irm https://raw.githubusercontent.com/fsbtactic-code/pishi-normalno/v1.0.0/install.ps1 | iexcurl -fsSL https://raw.githubusercontent.com/fsbtactic-code/pishi-normalno/v1.0.0/install.sh | bash& ([scriptblock]::Create((irm https://raw.githubusercontent.com/fsbtactic-code/pishi-normalno/v1.0.0/install.ps1))) -Target claudecurl -fsSL https://raw.githubusercontent.com/fsbtactic-code/pishi-normalno/v1.0.0/install.sh | bash -s -- --target claudeДля Claude, Claude Desktop и ChatGPT используется готовый ZIP-пакет релиза. Для обычного ChatGPT без Workspace Agents подготовлен единый MD-файл.
Полная пошаговая инструкция с проверкой установки и обновлением: INSTALL.md.
Инсталляторы привязаны к релизу, проверяют SHA256, не перезаписывают существующую установку без флага обновления и сохраняют резервную копию предыдущей версии.
В agents/openai.yaml включен allow_implicit_invocation: true. В совместимом клиенте пользователю не нужно каждый раз писать название скилла.
Примеры запросов, которые должны его активировать:
Напиши пост для Telegram по этим фактам.Сделай текст лендинга живее, но не меняй обещания.Отредактируй письмо и сохрани мой тон.Убери машинную манеру из этого текста.Подготовь анонс функции для пользователей.
Не все агенты читают OpenAI metadata. Для таких клиентов есть готовый шаблон AGENTS.md. Он добавляет явную маршрутизацию без необходимости называть скилл в каждом запросе.
После pip install . доступна команда:
pishi-normalno audit post.md --genre social --strictСравнение с исходником:
pishi-normalno audit result.md --source source.md --genre marketing --strictПроверка текста из stdin:
printf '%s' 'Аккуратный промпт. Трата твоего времени.' | pishi-normalno audit - --genre socialМашиночитаемый отчет:
pishi-normalno audit result.md --source source.md --genre social --jsonДиагностика установки:
pishi-normalno doctor
pishi-normalno whereКоды завершения:
0: блокирующих проблем нет;1: найдена ошибка или warning при--strict;2: ошибка аргументов, пути или конфигурации.
Аудитор не определяет, кто написал текст. Его сигналы помогают редактору найти формальные и составные проблемы.
| Режим | Что делает |
|---|---|
edit |
Исправляет только то, что мешает |
sharpen |
Усиливает хук, аргумент, конкретику или финал |
rewrite |
Полностью перестраивает сломанный текст |
write |
Пишет новый текст по фактам и брифу |
audit |
Показывает проблемы без переписывания |
embedded |
Проводит финальный проход внутри другой задачи |
При разработке Пиши нормально мы изучали и использовали подходы из ilyautov/humanizer-ru, в частности модульную архитектуру, несколько независимых проходов, каталог русских паттернов, внимание к ложным срабатываниям, optional-морфологию и eval-подход.
humanizer-ru распространяется по лицензии MIT. Автор: Ilya Utov. Полное уведомление находится в THIRD_PARTY_NOTICES.md.
Проект не связан с Ильей Утовым, не одобрен им и не является официальным продолжением humanizer-ru. Мы открыто показываем, на что опирались, что изменили и где выбрали другой путь.
Сравнение относится к humanizer-ru версии 3.15.1 от 21 июля 2026 года.
| Критерий | Пиши нормально |
humanizer-ru |
|---|---|---|
| Главная цель | Качество русского текста, сохранность смысла и голоса | Устранение AI-паттернов, включая detector-oriented метрики |
| Написание с нуля | Да | В metadata исключено |
| Сверка с исходником | Детерминированная проверка фактов, модальности, причинности, выгод и связей | Fact lock и редакторский аудит |
| Маркетинг и SMM | Отдельный слой доказательств, каналов, CTA и происхождения выгод | Общие жанровые стратегии и шаблоны |
| Ритм | Меняется только по смыслу и голосу | Используются perplexity, burstiness и контрастные замены |
| AI-детекторы | Не оптимизируется и не обещает обход | Детекторные признаки являются частью заявленной цели |
| Автоматический вызов | OpenAI metadata и переносимый AGENTS-шаблон | Зависит от способа установки и клиента |
| Публичная зрелость | Новый проект, 80 автоматических тестов в первом релизе | Более зрелый проект, 54 паттерна, релизы и публичная история |
Мы сознательно не переносили намеренные ошибки, квоты на сленг, метафоры и длину фраз, обязательную замену предсказуемых слов и произвольный процент человечности. Такие приемы могут менять статистический рисунок, но не гарантируют естественную русскую речь.
Это сравнение областей применения и архитектурных решений, а не рейтинг качества проектов.
Подробности и ссылки на конкретные материалы собраны в исследовательской базе.
- Агент фиксирует факты, голос, энергию текста и связи между частями.
- Выбирает минимальную силу вмешательства.
- Проверяет задачу, доказательства, композицию, русский синтаксис и жанр.
- Детерминированный аудитор ищет формальные артефакты и source-aware расхождения.
- Финальный смысловой проход проверяет то, что нельзя надежно решить регулярным выражением.
Подробное устройство описано в docs/architecture.md.
В папке demo лежат исходник, намеренно плохая редактура и исправленная версия. Проверка запускается так:
pishi-normalno audit demo/bad-result.md --source demo/source.md --genre social --strict
pishi-normalno audit demo/clean-result.md --source demo/source.md --genre social --strictpython -m unittest discover -s tests -v
python tools/validate_repo.py
python tools/package_skill.py
ruff check .
mypy skills/pishi-normalno/scripts tools testsCI проверяет Python 3.10, 3.12 и 3.13 на Ubuntu и Windows, переносимость скилла, запрещенные кодовые точки, локальные пути, CLI, установку и детерминированность release-архива. В первом релизе проходят 80 автоматических тестов.
Скилл и аудитор работают локально. CLI не отправляет текст во внешние сервисы, не собирает телеметрию и не требует API-ключей.
Новые паттерны принимаются только вместе с плохим примером, хорошим вариантом, контрпримером и тестом на ложное срабатывание. Подробности находятся в CONTRIBUTING.md.
MIT, fsbtactic-code. Сторонние уведомления находятся в THIRD_PARTY_NOTICES.md.