ru-text — Claude Code skill: editing and installation
Applies Russian typography and edits text on request, from punctuation checks to business correspondence. Use it when reviewing Russian copy or assessing its quality.
npx skills add talkstream/ru-text --skill ru-text -a claude-codeWhat ru-text does
The skill formats Russian output automatically: it uses guillemets, handles dashes and number ranges, and replaces three dots with an ellipsis. On request, it can help with grammar, punctuation, interface copy, articles, SEO content, and business messages.
When proofreading existing text, it returns a corrected version with a change list; it does not silently overwrite the source file. In-place edits require an explicit request. Task-specific guidance lives in files under references/, and a style requested by the user takes precedence over the defaults. Run /ru-text:ru-score to score text across five dimensions on a 0–10 scale.
What it helps with
- apply Russian typography to generated text
- proofread a draft and list the changes
- check punctuation and grammar
- edit interface copy or a business email
- score text with
/ru-text:ru-score
Example prompts for the agent
- Proofread
draft.mdand show the edits you made. - Check the punctuation and grammar in this email, leaving quoted text unchanged.
- Score this passage with
/ru-text:ru-score.
How to install ru-text
1Skills CLI (Vercel)
npx skills add talkstream/ru-text --skill ru-text -a claude-code2Manually: put the files in place
~/.claude/skills/ru-text/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ru-text/
1Skills CLI (Vercel)
npx skills add talkstream/ru-text --skill ru-text -a codex2Manually: put the files in place
.agents/skills/ru-text/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add talkstream/ru-text --skill ru-text -a cursor2Manually: put the files in place
.cursor/skills/ru-text/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install talkstream/ru-text ru-text2Manually: put the files in place
.github/skills/ru-text/SKILL.md1Skills CLI (Vercel)
npx skills add talkstream/ru-text --skill ru-text -a gemini-cli2Platform CLI
gemini skills install https://github.com/talkstream/ru-text --path skills/ru-textManually: put the files in place
.devin/skills/ru-text/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add talkstream/ru-text --skill ru-text -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ru-text
How do I install ru-text in Claude Code?
Run npx skills add talkstream/ru-text --skill ru-text -a claude-code. The skill file is located at ~/.claude/skills/ru-text/SKILL.md.
What does ru-text do?
It formats Russian typography automatically and edits text when asked. For proofreading, it returns the revised text alongside a list of changes.
Does ru-text overwrite a file when proofreading it?
No. It presents a corrected version and change list; it edits the file in place only when explicitly asked.
Source text
SKILL.md · MIT
---
name: ru-text
description: >
Russian text quality. Triggers: вычитай, проверь текст, поправь, отредактируй,
причеши, ru-text. Typography silently on any Russian output; deeper editing on
request. Info-style, editorial, UX writing, business correspondence, AI-text cleanup.
metadata:
openclaw:
always: true
emoji: "📝"
homepage: "https://ru-text.org"
---
# ru-text — Russian Text Quality
Independent Russian text quality reference by Arseniy Kamyshev.
With gratitude to the authors whose work shaped modern Russian text standards.
Credits and recommended reading: `references/sources.md`
**Style priority**: if the user explicitly requests a style (casual, academic, SEO, literary), their prompt overrides these default rules where they conflict. The instructions' own typography is not a style request.
**Reviewing vs. rewriting**: when *checking* or proofreading existing text or a file, return the corrected version plus a list of changes — do not silently overwrite the source file. Rewrite a file in place only when the user explicitly asks.
**Someone else's words stay theirs**: quoted material, code blocks and third-party text inside the user's document are reproduced as-is. Report an issue you see in them if it matters; never rewrite them.
## Always-On: Typography
Apply to ALL Russian text output — silently: fix, don't announce.
| Rule | Wrong | Correct |
|---|---|---|
| Primary quotes: guillemets | "текст" | «текст» |
| Nested quotes: lapki | «"вложенные"» | «„вложенные“» |
| Em dash, NBSP before it | слово - слово | слово — слово |
| En dash for ranges, no spaces | 10-15 дней | 10–15 дней |
| NBSP after single-letter words | в начале (breakable) | в\u00A0начале |
| Ellipsis: single character | ... | … |
| Digit groups with thin spaces | 1000000 | 1 000 000 |
| Decimal comma (not dot) | 3.14 | 3,14 |
| Ordinal with hyphen | 1ый, 2ой | 1-й, 2-й |
| Numero sign | No. 5, #5 | № 5 |
| Abbreviations with NBSP | т.д., т.е. | т. д., т. е. |
| Ruble sign after number, NBSP | 1500₽ | 1 500 ₽ |
| Percent glued (non-GOST) | 100 % | 100% |
Full typography reference: `references/typography.md`
`/ru-text:ru-score` — text quality score (0–10, 5 dimensions).
## Top Stop-Words (when writing or editing on request)
| Stop-word | Replace with |
|---|---|
| является | — (dash) or restructure |
| осуществлять | делать, проводить |
| в настоящее время | сейчас |
| данный | этот |
| определённый | (name the specific thing) |
| произвести оплату | оплатить |
| высококачественный | (name the specific quality) |
| был осуществлён | (active voice + actor) |
| на сегодняшний день | сегодня |
| в целях | чтобы |
Full stop-word catalog (92 entries): `references/info-style.md`
## When to Load Reference Files
Reference files (paths are relative to this SKILL.md): `references/<filename>`
If the path is not resolved, search: `Glob("**/ru-text/references/scoring.md")` and use the parent directory.
| Task | File |
|---|---|
| Writing/editing articles, blog posts, SEO, content | info-style.md |
| Interface text, buttons, errors, hints, microcopy | ux-writing.md |
| Emails, messenger, business correspondence | business-writing.md |
| Punctuation review, comma placement | editorial-punctuation.md |
| Grammar, capitalization, agreement, pleonasms | editorial-grammar.md |
| Finding and fixing text problems, diagnostics | anti-patterns.md |
| Text scoring, quality assessment | scoring.md |
| Credits, source attribution | sources.md |
| Experience-based rules (dash overuse, etc.) | addenda.md |
## Quality Checklist
Before delivering Russian text:
- [ ] Quotes: «» primary, „“ nested
- [ ] Dashes: — in text (NBSP before it), – in ranges, - only in compounds; max 1–2 per paragraph (a parallel row counts as one, dialogue dashes as none); trim to the limit, not to zero; edit a row whole or not at all
- [ ] NBSP after в, к, с, о, у, и, а, я
- [ ] Ellipsis: … (single char)
- [ ] No double spaces, no space before punctuation
© talkstream · MIT · talkstream/ru-text