ru-text — плагин для ИИ-агентов, который убирает канцелярит и типографический шум в русском тексте

ru-text — бесплатный навык вычитки русского текста для ИИ-агентов. Он исправляет типографику и канцелярит, выявляет 17 признаков машинного текста и помогает редактировать интерфейсные тексты и деловую переписку.

Что делает ru-text

ru-text работает внутри ИИ-агента и подключает справочники, когда задача касается качества русского текста. Навык поддерживает Claude Code, Codex и ChatGPT, Cursor, GitHub Copilot, Gemini CLI, Google Antigravity, Windsurf, Continue.dev, Cline, JetBrains Junie, OpenClaw и Notion.

Основные возможности:

• исправление кавычек, тире, пробелов, сокращений и других типографских деталей;
• очистка канцелярита, пассивных конструкций и стоп-слов;
• поиск 17 характерных признаков машинного текста, включая пустые зачины, сервисные реплики ассистента и ложные антитезы;
• проверка пунктуации, грамматики и структуры;
• редактура кнопок, ошибок, форм, уведомлений и других UX-текстов;
• улучшение писем и сообщений;
• оценка текста по шкале от 0 до 10.

При проверке чужого текста навык возвращает исправленный вариант и список изменений с цитатами и правилами. Файл меняется только по прямой просьбе пользователя. Цитаты, код и вложенные чужие фрагменты воспроизводятся как есть.

Как устроен корпус

В репозитории, проверенном 4 сентября 2026 года, корпус разделён на десять справочников:

Постоянно в контексте находится только основной файл объёмом около 4 КБ. Остальные справочники загружаются по необходимости. При явной просьбе вычитать текст агент читает весь корпус.

Быстрая самопроверка охватывает типографику и верхнюю часть списка стоп-слов. Если находится не меньше пяти замечаний или признак машинного текста, проверка расширяется до полной. Быстрый проход не выдаётся за полную вычитку.

Установка ru-text

Команды и список площадок ниже сверены с официальным репозиторием и документацией, доступными на 4 сентября 2026 года. Перед установкой проверяйте актуальный INSTALL.md: платформенные интерфейсы и команды могут меняться.

README проекта предлагает дать агенту такую установочную просьбу:

Установи навык https://github.com/talkstream/ru-text глобально и вызывай его, когда работа идёт над качеством русского текста: вычитка, типографика, очистка от нейрослопа, редактура, UX-тексты, деловая переписка — или по прямому упоминанию ru-text.

После установки начните новую сессию: многие агенты загружают навыки при старте.

Для установки через универсальный менеджер навыков:

npx skills add talkstream/ru-text

Эта команда устанавливает три навыка проекта в текущий проект. Если нужен только ru-text в каталоге выбранного агента, README проекта предлагает другой установщик:

npx skillsbd add talkstream/ru-text/ru-text

Точные флаги и команды для отдельных платформ приведены в INSTALL.md.

Claude Code

ru-text доступен через community-маркетплейс Claude Code — каталог сторонних плагинов:

/plugin marketplace add anthropics/claude-plugins-community
/plugin install ru-text@claude-community

README проекта предупреждает, что community-маркетплейс может отставать от свежей версии репозитория на несколько месяцев. Проверить установленный плагин можно в /plugin на вкладке Installed или командой /plugin list. Если после установки появится сообщение Run /reload-plugins to activate, выполните /reload-plugins или начните новую сессию.

Codex и ChatGPT

В ChatGPT навык устанавливается из карточки в каталоге плагинов. После установки он доступен в браузере, настольном и мобильном приложениях; в Codex внутри настольного приложения используется тот же навык.

Для Codex CLI используйте установочную просьбу со ссылкой на репозиторий или команды из актуального INSTALL.md.

Остальные агенты

Для Cursor, GitHub Copilot, Gemini CLI, Windsurf, Continue.dev, Cline и JetBrains Junie используйте универсальную установочную команду или платформенные инструкции из INSTALL.md. Для OpenClaw и других поддерживаемых агентов также сверяйтесь с актуальными инструкциями репозитория.

Проверка установки

1. Начните новую сессию агента.
2. Передайте абзац с прямыми кавычками, дефисом вместо тире и канцелярской конструкцией.
3. Попросите: «Вычитай этот текст по ru-text».
4. Проверьте, что ответ содержит исправленный текст и список изменений с правилами.

Если исправления есть, но списка нет, навык мог не загрузиться. Проверьте установленную версию и инструкции по диагностике в INSTALL.md.

В Claude Code доступны две отдельные команды:

На других платформах достаточно обычной просьбы: «Вычитай по ru-text» или «Оцени этот текст по ru-text».

Что означает оценка

Оценка помогает проверять типографику, ясность, грамматику и структуру перед публикацией. Команда /ru-text:ru-score возвращает результат от 0 до 10 по пяти шкалам. Каждое замечание должно сопровождаться цитатой и правилом, поэтому результат можно проверить и оспорить.

Рубрика отдельно сообщает, чего она не измеряет: фактическую точность, попадание в аудиторию, авторский голос, оригинальность, эффективность и соответствие брифу. Голос в балл не входит: одинаковый результат может получить осторожный и резкий текст.

Порог вроде 8,0 можно использовать как внутренний ориентир, но официальный источник не определяет его как универсальный стандарт качества. Перед автоматизацией лучше прогнать собственные эталонные тексты и выбрать порог по их результатам.

Когда правила уступают задаче

ru-text задаёт редакторские умолчания, а не обязательный стиль. Прямая просьба писать разговорно, академически, юридически, художественно или для поисковой оптимизации имеет приоритет.

Мандат тоже определяет пользователь. Фраза установки просит вызывать навык, когда работа идёт над качеством русского текста или когда пользователь прямо упоминает ru-text. При необходимости мандат можно сузить до явной просьбы о вычитке или расширить до любого русского текста.

При проверке навык возвращает исправленный вариант и список изменений; файл правится только по прямой просьбе пользователя. Цитаты, код и чужие фрагменты внутри документа воспроизводятся как есть.

Разговорный регистр в версии 2.3.0

Каталог стоп-слов больше не предписывает безусловно удалять «ну», «кстати» и «как-то»: в разговорном регистре, включая соцсети, личный блог, чат поддержки и сообщение коллеге, эти записи не применяются. В остальных регистрах они применяются как прежде.

Единица оценки — отрезок, а не файл: в одном документе могут соседствовать разные регистры. Три и более различных признака машинного текста в одном отрезке отменяют эту оговорку.

Полезные сценарии

Вычитка статьи или README

Передайте готовый черновик и запросите полную проверку. Наблюдаемый результат — исправленный вариант и перечень правок с правилами. Проверка улучшает форму, но не подтверждает факты и не заменяет редактора.

UX-тексты продукта

Передайте набор кнопок, ошибок, уведомлений и пустых состояний с контекстом интерфейса. Навык проверит, называет ли кнопка действие и объясняет ли ошибка, что произошло и что делать дальше. Итог нужно проверить в самом интерфейсе: длина и смысл зависят от конкретного экрана.

Деловое письмо

Передайте адресата, цель и черновик письма. ru-text уберёт канцелярские обороты и предложит более прямую структуру. Факты, имена и обязательства он не должен придумывать: недостающие сведения агенту следует запросить.

Контроль публикационного контура

Перед публикацией запросите оценку и сохраните замечания вместе с результатом. Автоматический порог полезен только после калибровки на собственных текстах. Отдельная проверка фактов остаётся обязательной.

Подключение ru-text к Notion

Пользовательские навыки (Custom Skills)

Пользовательские навыки в Notion AI доступны на тарифах Business и Enterprise. Страницу можно назначить навыком через меню ··· → Use with AI → Use as AI skill, а затем вызывать из меню выделенного текста или через упоминание в чате агента.

Notion MCP

Официальный Notion MCP — сервер для подключения MCP-клиентов к рабочему пространству. После авторизации клиент может читать и обновлять доступный пользователю контент.

Для Claude Code:

claude mcp add --transport http notion https://mcp.notion.com/mcp

Затем откройте /mcp и завершите OAuth-авторизацию. На 4 сентября 2026 года официальный сервер требует интерактивного OAuth и пока не поддерживает полностью неинтерактивную авторизацию для автоматических процессов.

Ограничения навыка

• Навык работает с русским языком.
• Он улучшает форму текста, но не проверяет истинность утверждений.
• Оценка не измеряет авторский голос, оригинальность и соответствие аудитории.
• Результат вычитки требует человеческого решения: не каждое замечание нужно принимать.
• Установка копированием обычно не обновляется автоматически.
• Редакторские умолчания могут не совпасть с голосом бренда; иной голос нужно явно описать в запросе.
• По заявлению проекта, сам навык не выполняет сетевых запросов и не собирает данные. Подключённые агенты и интеграции могут иметь собственные правила обработки данных.

Обновление ru-text

Следите за релизами официального репозитория через Watch → Custom → Releases. Для разовой установки копированием повтор команды установки может создать вложенную копию вместо обновления. Используйте платформенную команду обновления из актуального INSTALL.md.

В community-маркетплейсе Claude Code ru-text может отставать от свежей версии репозитория. Установленную версию проверяйте через интерфейс Claude Code, а при обновлении применяйте /reload-plugins, если Claude Code предложит это сделать, или начинайте новую сессию.

Официальные ссылки

• Официальный репозиторий ru-text
• Инструкция по установке
• Документация Claude Code по плагинам
• Подключение Notion MCP
• Пользовательские навыки в Notion AI

Следующий шаг

Если вы строите контентный процесс из нескольких источников, следующим шагом может быть Graphify — превращаем папку с файлами в граф знаний для ИИ-агентов.

Связанные материалы

• Блог: Материал о ru-text для ИИ-агентов

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

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov