# Bg Text

> Use when writing, editing, or reviewing Bulgarian-language text, or when user mentions bg-text. Covers typography, clear writing, editorial review, UX writing, business correspondence, localization, and Bulgarian-specific language issues. Auto-activates on Bulgarian text output.

- Skill: `actepukc/bg-text-2` (Agent Skill, multi-file: 13 files)
- Install (CLI): `npx skillmds@latest add actepukc/bg-text-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/actepukc/bg-text-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- Author: AcTePuKc (https://skillmd.com/u/actepukc)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/actepukc/bg-text-2

---


# bg-text — Качество на българския текст

Справочник за качествен български текст в съвременно писане, локализация, интерфейсни текстове и редакторски преглед.

**Приоритет на стила**: ако потребителят изрично поиска конкретен стил (разговорен, академичен, SEO, художествен, технически, UI, локализация за игри и т.н.), това има предимство пред общите правила тук. Тези правила са подразбиране, не догма.

**Източникова дисциплина**: не представяй редакторска практика или UX евристика като твърда книжовна норма. За норма се опирай първо на Института за български език при БАН, BERON и Службата за езикови справки. За стилови и продуктови решения ги маркирай като редакторска, локализационна или проектна практика. Ако трябва да цитираш опора, започвай от `references/sources.md`.

**Проверено срещу външни източници**:
- `„…“` и `‚…‘`, десетичната запетая, редните числителни с точка или дефисно окончание и пунктуационните правила са в обхвата на ИБЕ/БЕРON.
- `ѝ` е част от книжовната употреба и се среща последователно в материалите на ИБЕ.
- правила като `-` вместо `—` в дигитален текст, кратък UI текст, ограничена пунктуация в интерфейс и избягване на бюрократичен изказ са редакторска и UX практика, не академична норма.
- `corpusbdr.info` е полезен научен ресурс за диалектология, но не е първичен нормативен източник за книжовен правопис и пунктуация.

Кратки опорни връзки:
- ИБЕ, Езикови справки: `https://ibl.bas.bg/ezikovi-spravki/`
- ИБЕ, пример за кавички: `https://ibl.bas.bg/ezikovispravki/vaprosi/kavichki-8`
- ИБЕ, Речник на българския език, „запетая“: `https://ibl.bas.bg/rbe/lang/bg/запетая/`
- ИБЕ, редни числителни с арабски цифри: `https://ibl.bas.bg/ezikovispravki/vaprosi/chislitelni-imena-sheyset-i-shestdeset-7-klas-7-i-klas-vii-klas-39-oto-2014-a-5/294`
- BERON: `https://beron.mon.bg/beron`

## Винаги активни: типография

Прилагай тези правила към всеки български текст, освен ако потребителят изрично не иска друго. Таблицата по-долу съдържа само високоуверени правила; по-спорните или стилови предпочитания са в `references/typography.md`.

| Правило | Грешно | Правилно |
|---|---|---|
| Primary quotes | "текст" | „текст“ |
| Nested quotes | „"вложен текст"“ | „‚вложен текст‘“ |
| En dash for ranges | 10-15 дни | 10–15 дни |
| No space before punctuation | текст , текст | текст, текст |
| One space after punctuation | текст,текст | текст, текст |
| Ellipsis: single character | ... | … |
| Decimal comma | 3.14 | 3,14 |
| Правилно българско ѝ | й даде книгата | ѝ даде книгата |
| Abbreviations with spaces | т.н., т.е. | т. н., т. е. |
| Avoid repeated punctuation | ...?! | ? / ! / … |

Пълен справочник по типография: `references/typography.md`

`/bg-text:bg-score` — оценка за качество на текста (0-10, 5 измерения).

## Основни приоритети за български език

Българският трябва да се третира като самостоятелен език, а не като руски с други думи.

Предпочитай:
- естествен съвременен български
- утвърдени български термини, когато има такива
- ясна и директна формулировка
- културно естествен превод вместо механична транслитерация
- деятелен залог, когато прави текста по-ясен
- кратък и четим UI текст
- тон и обръщение, съобразени с контекста, без автоматично преминаване към формално „Вие“
- съгласуване по род и контекст, когато е нужно
- превод на техническите термини според функцията им, а не според английската дума сама по себе си

Избягвай:
- руска лексика и руски словоред
- руски типографски навици в стандартен български текст
- буквален превод от английски, когато има естествен български вариант
- бюрократичен изказ
- раздут номинален стил
- неоснователен дрейф към формално „Вие“ в UI, локализация, игри, общности и неформални продукти
- тромави неутрални конструкции, когато родът е ясен или може да се изрази по-чисто
- механично превеждане на `hook`, `fix`, `module`, `handler` и други технически думи без проверка какво реално правят

## Технически термини и заемки

**Статут:** редакторска и локализационна практика; терминът в изходния код може да остане непроменен.

При технически текст първо установи ролята на термина, после избери българската формулировка:

1. Запази английския термин, ако е идентификатор, име на API, команда, формат или установено име на технология.
2. Преведи го, ако е видим за играч или потребител и има естествен български еквивалент.
3. Ако няма единен еквивалент, предпочети кратко функционално описание пред буквална заемка.
4. Не добавяй техническа точност, която липсва в източника. `hook` не означава автоматично „модул“, „прихващач“ или „кука“.

Пример за `compatibility hook`:

| Контекст | Предпочитано | Избягвай като автоматичен избор |
|---|---|---|
| UI или бележка за играча | `механизъм за съвместимост` / `допълнение за съвместимост` | `кука за съвместимост` |
| техническо описание на изпълнение | `обработчик за съвместимост` / `точка за включване за съвместимост` | `модул`, ако не е отделен модул |
| действителна поправка на дефект | `поправка за съвместимост` / `корекция за съвместимост` | `фикс`, освен ако проектът съзнателно използва жаргон |

Пример: `The journal level label was corrected through the compatibility hook.` може да стане „Надписът за нивото в дневника е коригиран чрез механизма за съвместимост.“ Не избирай „прихващач“ или „кука“, ако читателят не е разработчик и терминът не е обяснен.

Проверявай изрично и многозначни технически думи. Те не бива да се превеждат по първото им възможно значение:

| Английски | Възможни български значения според контекста | Не приемай автоматично |
|---|---|---|
| `support` | поддръжка, съвместимост, помощ, подкрепа | `поддръжка` |
| `state` | състояние, етап, режим, статус | `статус` |
| `patch` | поправка, корекция, обновление | `пач` |
| `build` | версия, компилация, компилирана версия, изграждане | `билд` |
| `release` | издание, версия, публикуване | `релийз` |
| `slot` | място, позиция, място за запазена игра | `слот` |

При повтарящ се термин предложи кратък глосар или задай въпрос при първата неясна употреба. Не сменяй избрания превод в останалия текст без причина.

## Чести слаби думи и конструкции

| Слаба формулировка | Заменете с |
|---|---|
| осъществявам | правя, извършвам |
| извършвам проверка | проверявам |
| вземам решение | решавам |
| явява се | е |
| във връзка с | за, относно |
| с цел | за да |
| посредством | чрез |
| към настоящия момент | сега |
| на този етап | сега, засега |
| има възможност | може |
| следва да | трябва |
| необходимо е | трябва |
| направете клик | натиснете |
| осъществете достъп | отворете / влезте |
| извършете плащане | платете |

Пълен списък със слаби формулировки: `references/clear-writing.md`

## Кога да се зареждат справочните файлове

Справочни файлове (пътищата са относителни към този `SKILL.md`): `references/<filename>`
Ако пътят не се разреши, търси `Glob("**/bg-text/references/scoring.md")` и използвай родителската директория.

| Задача | Файл |
|---|---|
| Писане и редакция на статии, блогове, SEO и общо съдържание | clear-writing.md |
| Интерфейсни текстове, бутони, грешки, подсказки и микротекстове | ux-writing.md |
| Имейли, чат и бизнес кореспонденция | business-writing.md |
| Преглед на пунктуация и запетаи | editorial-punctuation.md |
| Граматика, главни букви, съгласуване и плеоназми | editorial-grammar.md |
| Намиране и поправяне на текстови проблеми | anti-patterns.md |
| Оценка и качествен преглед на текст | scoring.md |
| Източници и атрибуция | sources.md |
| Натрупани правила от практика и бележки по локализация | addenda.md |

## Контролен списък за качество

Преди да върнеш български текст:

- [ ] Кавичките са „“, а вложените кавички са ‚‘
- [ ] Средното тире (–) се използва за диапазони, когато контекстът е редактиран текст
- [ ] Няма двойни интервали и няма интервал преди пунктуация
- [ ] Има по един интервал след пунктуация, когато е нужно
- [ ] Използва се … само когато е нужно
- [ ] Abbreviations: т. н., т. е., т. п.
- [ ] Десетичната запетая е използвана правилно
- [ ] Българското ѝ е използвано правилно
- [ ] Редакторските и UX предпочитания не са представени като твърда езикова норма
- [ ] Няма руска лексика или руски словоред
- [ ] Няма буквален английски превод, когато има естествен български вариант
- [ ] Няма бюрократичен или раздут изказ
- [ ] UI текстът е кратък и четим
- [ ] Обръщението е последователно и подходящо за контекста: „ти“, „Вие“ или неутрална конструкция
- [ ] Предпочетен е деятелен залог, когато е уместно
- [ ] Тонът съответства на аудиторията и контекста