russian-text-quality — скилл

Скилл Claude Code, который ищет ошибки русского языка в коде: неполные формы множественного числа, падежи в склейке строк, разнобой терминов

  • 6 ★ репозитория
  • Последний коммит
  • MIT
Скилл

Минимальный доступ

Почему такой уровень

  • Скилл состоит из инструкций и справочников
  • Правки в локалях вносятся только после подтверждения
Все причины и проверки
Российский стек

anic888/russian-text-quality

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/russian-text-quality

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Минимальный доступИнструмент ничего не запускает и не ходит в сеть.

  • Скилл состоит из инструкций и справочников
  • Правки в локалях вносятся только после подтверждения

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл проверяет русские строки в коде и файлах локализации по пяти правилам. Самое строгое: в ключах i18next, ICU и vue-i18n должны быть все формы множественного числа по CLDR, иначе это ошибка. Предупреждениями отмечаются разные переводы одного термина, склейка строк после слов, требующих другого падежа, и смесь языков в комментариях. Транслитерированные имена переменных вроде polzovatel помечаются как информация. Скилл включается, только если в проекте есть кириллица, а отчет пишет по-английски, чтобы его понял и не говорящий по-русски ревьюер.

Для кого. Для команд, у которых код на английском, а интерфейс или комментарии на русском.

Подходит, если

  • Перед мержем PR, который меняет ru.json, ru.yml или ru.po
  • Агент перевел или отрефакторил файлы локализации и нужно проверить формы множественного числа
  • Нужно навести порядок в терминах, например пользователь и юзер в разных файлах

Не подходит, если

  • Нужна типографика, орфография или восстановление буквы «е»
  • Нужна редактура текстов интерфейса, а не структурные проверки

Пример запроса к агенту

Проверь проект на ошибки в русских текстах, особенно формы множественного числа в локалях

Ограничения

Старый формат i18next v3 с суффиксом _plural не поддерживается. Проверки склейки строк и транслитерации эвристические и дают ложные срабатывания, поэтому их результаты никогда не отмечаются как ошибки. Термины сравниваются по отсечению окончаний без полной морфологии, вложенные ICU-конструкции могут пропускаться. Автоисправление есть только для форм множественного числа и только после подтверждения.

Как отключить. Удалите папку или симлинк russian-text-quality из ~/.claude/skills.

Частые вопросы

Не будет ли шума в английских проектах?

Нет, скилл запускается только при наличии кириллицы в коде или локалях, иначе сообщает, что не активирован.

Как закрепить единый перевод термина?

Скопируйте пример глоссария в .claude/russian-glossary.yml и укажите нужные варианты, он заменит автоматический поиск разнобоя.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

Скилл вычитки русского текста: типографика, канцелярит и 17 признаков машинного текста, с правилом на каждую правку

СкиллМинимальный доступ281Звезды репозитория
Российский стек

Скилл-редактор и линтер для русского текста после нейросети: канцелярит, пустые зачины, штампы и обертки чат-бота

СкиллМинимальный доступ17Звезды репозитория
Российский стек

Редактор русского текста после нейросети: убирает канцелярит, штампы и признаки AI по 38 паттернам, факты не трогает

СкиллМинимальный доступ199Звезды репозитория
Российский стек

Скилл, который учит агента писать комментарии, документацию и сообщения об ошибках по правилам УТР из ГОСТ Р 58049-2017, плюс линтер

СкиллРасширенный доступ15Звезды репозитория
Российский стек

Скилл редактуры русского текста: снимает канцелярит, кальки и нейросетевую манеру, не трогая факты, со сканером для измеримой правки

СкиллРасширенный доступ496Звезды репозитория
Российский стек

Скилл редактуры русского текста по инфостилю Ильяхова: убирает стоп-слова и штампы, подставляет факты, показывает правки до и после

СкиллМинимальный доступ35Звезды репозитория

Коротко о README

README объясняет, какие ошибки русского языка пропускают линтеры и модели, и перечисляет пять проверок с уровнями серьезности. Установка сводится к клонированию и симлинку в ~/.claude/skills. Описаны условия активации, пример отчета и честный список ограничений. За типографикой и орфографией автор отправляет к отдельным инструментам, например ru-text и yaspeller. Лицензия MIT.

Бейдж для README

Исходный SKILL.md

---
name: russian-text-quality
description: Use when reviewing or writing code that contains Russian-language UI strings, i18n locale files (ru.json, ru.yml, ru.po), Russian comments, or transliterated identifiers (polzovatel, tovar, kolichestvo). Triggers on mixed English-code + Russian-content projects. Does not cover typography, spelling, or ё/е.
---

# Russian Text Quality Review

## Overview

Detects Russian-language quality bugs that general linters and LLMs consistently miss in code: broken pluralization in i18n locale files, case-agreement bugs in string concatenation, terminology drift across files, transliterated identifiers, and inconsistent language mixing. Code-aware, not prose-focused.

**Core principle:** structural Russian mistakes that survive `eslint` and type-checks but break production UIs. Prose quality is delegated to other tools.

## Activation

Run this skill ONLY if BOTH conditions hold:

1. The project contains **≥10 total Cyrillic characters** across code and locale files (excluding `node_modules`, `.git`, `dist`, `build`, and `.gitignore`d paths).
2. At least one file contains **≥5 consecutive Cyrillic characters** (rules out single stray tokens).

If either condition fails, respond with `Not activated — no Russian content detected` and stop. Never run on English-only projects.

Full activation pseudo-code: `references/activation-logic.md`.

## What this skill checks

| # | Check | Detection | Severity | Confidence |
|---|---|---|---|---|
| 1 | **Plural structure** — i18next/ICU/vue-i18n Russian plurals missing CLDR categories (`one`/`few`/`many`/`other`) | Deterministic parse of locale files + call sites | **Error** | High |
| 2 | **Terminology drift** — same source key translated to different Russian terms across files, or known-synonym variance | Normalized value comparison | Warning | Medium |
| 3 | **Concatenation case bug** — Russian preposition/verb governing non-nominative case followed by string interpolation | Heuristic regex + closed trigger list | Warning | Medium |
| 4 | **Language mixing** — inconsistent comment language in a single file, or inline Russian literals outside i18n | Per-file line-language ratios | Warning | Medium |
| 5 | **Transliterated identifiers** — `polzovatel`, `tovar`, `kolichestvo` etc. | Dictionary + phonotactic + file-context (3-tier) | Info | Low |

Сообщить о проблеме

Foxx AIrussian-text-quality
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.