Skip to content

Commit 7932d7c

Browse files
authored
Merge pull request #6 from talkstream/add-root-skill-md
Add root SKILL.md for directory compatibility
2 parents 515b914 + 98c3ee1 commit 7932d7c

File tree

1 file changed

+94
-0
lines changed

1 file changed

+94
-0
lines changed

SKILL.md

Lines changed: 94 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,94 @@
1+
---
2+
name: ru-text
3+
description: >
4+
Use when writing, editing, or reviewing Russian-language text, or when user
5+
mentions ru-text. Covers typography, info-style, editorial, UX writing, business
6+
correspondence. Auto-activates on Russian text output.
7+
---
8+
9+
# ru-text — Russian Text Quality
10+
11+
Independent Russian text quality reference by Arseniy Kamyshev.
12+
With gratitude to the authors whose work shaped modern Russian text standards.
13+
Credits and recommended reading: [sources.md](skills/ru-text/references/sources.md)
14+
15+
**Style priority**: if the user explicitly requests a specific style (casual, academic, SEO, literary, etc.), their prompt overrides these default rules where they conflict. These rules are defaults, not mandates.
16+
17+
## Always-On: Typography
18+
19+
Apply these rules to ALL Russian text output without exception.
20+
21+
| Rule | Wrong | Correct |
22+
|---|---|---|
23+
| Primary quotes: guillemets | "текст" | «текст» |
24+
| Nested quotes: lapki | «"вложенные"» | «„вложенные"» |
25+
| Em dash with spaces | слово - слово | слово — слово |
26+
| En dash for ranges, no spaces | 10-15 дней | 10–15 дней |
27+
| NBSP after single-letter prepositions | в начале (breakable) | в\u00A0начале |
28+
| Ellipsis: single character | ... ||
29+
| Digit groups with thin spaces | 1000000 | 1 000 000 |
30+
| Decimal comma (not dot) | 3.14 | 3,14 |
31+
| Ordinal with hyphen | 1ый, 2ой | 1-й, 2-й |
32+
| Numero sign | No. 5, #5 | № 5 |
33+
| Abbreviations with NBSP | т.д., т.е. | т. д., т. е. |
34+
| Ruble symbol after number | 1500 руб | 1 500 ₽ |
35+
36+
Full typography reference: [typography.md](skills/ru-text/references/typography.md)
37+
38+
`/ru-text:ru-score` — text quality score (0–10, 5 dimensions).
39+
40+
## Top Stop-Words (remove or replace)
41+
42+
| Stop-word | Replace with |
43+
|---|---|
44+
| является | — (dash) or restructure |
45+
| осуществлять | делать, проводить |
46+
| в настоящее время | сейчас |
47+
| данный | этот |
48+
| определённый | (name the specific thing) |
49+
| произвести оплату | оплатить |
50+
| высококачественный | (name the specific quality) |
51+
| был осуществлён | (active voice + actor) |
52+
| на сегодняшний день | сегодня |
53+
| в целях | чтобы |
54+
55+
Full stop-word catalog (97 entries): [info-style.md](skills/ru-text/references/info-style.md)
56+
57+
## When to Load Reference Files
58+
59+
| Task | Load |
60+
|---|---|
61+
| Writing/editing articles, blog posts, SEO, content | [info-style.md](skills/ru-text/references/info-style.md) |
62+
| Interface text, buttons, errors, hints, microcopy | [ux-writing.md](skills/ru-text/references/ux-writing.md) |
63+
| Emails, messenger, business correspondence | [business-writing.md](skills/ru-text/references/business-writing.md) |
64+
| Punctuation review, comma placement | [editorial-punctuation.md](skills/ru-text/references/editorial-punctuation.md) |
65+
| Grammar, capitalization, agreement, pleonasms | [editorial-grammar.md](skills/ru-text/references/editorial-grammar.md) |
66+
| Finding and fixing text problems, diagnostics | [anti-patterns.md](skills/ru-text/references/anti-patterns.md) |
67+
| Text scoring, quality assessment | [scoring.md](skills/ru-text/references/scoring.md) |
68+
| Credits, source attribution | [sources.md](skills/ru-text/references/sources.md) |
69+
| Experience-based rules (dash overuse, etc.) | [addenda.md](skills/ru-text/references/addenda.md) |
70+
71+
## Quality Checklist
72+
73+
Before delivering Russian text:
74+
75+
### Typography (mandatory)
76+
- [ ] Quotes: «» primary, „" nested
77+
- [ ] Dashes: — in text, – in ranges, - only in compounds; max 1–2 per paragraph
78+
- [ ] NBSP after в, к, с, о, у, и, а
79+
- [ ] Ellipsis: … (single char)
80+
- [ ] Abbreviations: т. д., т. п. (with NBSP)
81+
- [ ] No double spaces, no space before punctuation
82+
83+
### Writing quality (when creating/editing)
84+
- [ ] No filler words (является, осуществляет, данный)
85+
- [ ] Specific claims backed by facts or numbers
86+
- [ ] Active voice preferred
87+
- [ ] One idea per paragraph
88+
- [ ] Reader benefit clear in every section
89+
90+
### Editorial (when proofreading)
91+
- [ ] No tautology or pleonasm
92+
- [ ] Lists grammatically homogeneous
93+
- [ ] Capitalization follows Russian norms (no Title Case)
94+
- [ ] Comma traps checked (однако, наконец, значит)

0 commit comments

Comments
 (0)