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

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

Full activation pseudo-code:

references/activation-logic.md

What this skill checks

one

few

many

other

polzovatel

tovar

kolichestvo

Full detection algorithms live in

references/plural-rules.md

references/concatenation-triggers.md

references/mixing-and-transliteration.md

.claude/russian-glossary.example.yml

What this skill does NOT check

Delegate these to purpose-built tools:

Review workflow

1. Check activation. If conditions not met, stop.
2. Detect i18n framework from

   package.json

   :

   i18next

   ,

   react-intl

   /

   @formatjs/*

   ,

   vue-i18n

   /

   @intlify/*

   , or none. If multiple, run all applicable detection strategies.
3. Run checks against matching file targets. Skip checks whose file types are absent.
4. Emit the Markdown report in the format below.
5. Do NOT modify files without explicit user approval. Findings are suggestions except for

   #1

   plural scaffolding, which may be auto-applied only when the user approves.

Output format

# Russian Text Review — <project name>

## Summary
- Files scanned: N
- Russian content detected in: M files
- Findings: X errors, Y warnings, Z info

## Findings

### Errors (must fix)
#### #1 Plural structure
- [HIGH] path/to/ru.json:L — key `items.count` missing `_few`, `_many` siblings
  - **Why:** Russian CLDR requires `one/few/many/other`. Missing `_few` produces wrong form for n=2,3,4.
  - **Fix:** add `items.count_few`, `items.count_many` entries (scaffolded below).

### Warnings
#### #5 Terminology drift
- [MEDIUM] locales/ru.json vs locales/admin/ru.json — key `user` translates to `пользователь` and `юзер`
  - **Why:** inconsistent terminology confuses users and breaks search.
  - **Fix:** pick one; lock via `.claude/russian-glossary.yml`.

### Info
#### #1 Transliterated identifiers
- [LOW] src/order.ts:12 — identifier `kolichestvo_tovarov` looks like transliterated Russian
  - **Suggestion:** `product_quantity` or keep Cyrillic if that is your project convention.

## External tools we recommend
- Typography / UX writing → talkstream/ru-text
- Spelling → yaspeller
- ё/е → eyo

The "External tools we recommend" block appears only when the scan finds Russian content. On English-only projects, the skill does not run at all.

Common mistakes when using this skill

• Running on English-only projects. Honor the activation guard. Do not bypass it to "check anyway".
• Flagging typography, spelling, or ё/е. These are explicit non-goals — delegate, do not duplicate.
• Treating medium-confidence heuristics as errors. Checks #3, #4, #5 emit warnings or info; never promote them to errors.
• Auto-fixing without approval. Only

  #1

  plural scaffolding can be offered as an auto-fix, and only after the user approves the suggested diff.
• Matching

  key_plural

  suffixes. This skill targets i18next v4 format only. Old v3 projects using

  key_plural

  are out of scope in v1: when detected, emit a single

  Info

  finding noting the v3 file was skipped, then stop plural checks for that file.

References

• references/plural-rules.md

  — CLDR Russian rules + per-framework detection algorithms (i18next, ICU, vue-i18n) with test cases. Includes Step 2.5 for locale values with count-placeholders but no plural siblings.

• references/concatenation-triggers.md

  — closed list of triggers for check #3 with exclusions

• references/mixing-and-transliteration.md

  — detection pseudo-code and thresholds for checks #4 and #5

• references/transliteration-dict.yml

  — seed dictionary used by check #5

• references/activation-logic.md

  — activation pseudo-code + test cases

• references/examples.md

  — 16 before/after cases sourced from real projects

• .claude/russian-glossary.example.yml

  — template for user-provided terminology glossary