# enhanced-message-context

Скилл enhanced-message-context для Claude Code расставляет комментарии для переводчиков в сообщениях Lingui и решает, каким строкам они нужны — двусмысленным подписям и непрозрачным плейсхолдерам вроде {count}.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 630 установок · ★ 12 у репозитория
- Автор: lingui
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/lingui/skills/tree/HEAD/skills/enhanced-message-context/SKILL.md
- Обновлён: 2026-10-20
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/enhanced-message-context

## Что делает

Сообщения делятся на три уровня. Обязательный комментарий получают короткие двусмысленные подписи («Back», «Delete»), действия без видимого объекта, термины, зависящие от домена продукта, и непрозрачные плейсхолдеры. Полные самостоятельные предложения остаются без комментария: они сами себе контекст. Цель — 100% в обязательном уровне, а не в каталоге целиком: ковровые комментарии приучают переводчика их пролистывать.

У `t`-шаблона нет аргумента, куда положить комментарий, поэтому обязательные строки скилл сразу пишет объектной формой `t({ comment: ..., message: ... })`. Для блока строк с общим описанием есть директива `lingui-set`, её закрывает `lingui-reset`; оставленная открытой, она цепляет одни и те же слова к тому, что допишут в файл позже. В `<Trans>` комментарий — обычный проп, его можно ставить на месте. Без объектной формы в `t` контекст не появится вообще.

Файлы в `components/ui/**` остаются нетронутыми, потому что `shadcn add` перезаписывает их целиком, и добавленный комментарий исчезнет при следующем обновлении. Аудит готовых каталогов скилл ведёт через `awk` в режиме абзацев по `messages.po` и показывает записи без `#.` вместе со ссылкой `#:`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingui/skills --skill enhanced-message-context -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/enhanced-message-context/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/enhanced-message-context/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingui/skills --skill enhanced-message-context -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/enhanced-message-context/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingui/skills --skill enhanced-message-context -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/enhanced-message-context/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install lingui/skills skills/enhanced-message-context
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/enhanced-message-context/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add lingui/skills --skill enhanced-message-context -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/lingui/skills --path skills/enhanced-message-context
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/enhanced-message-context/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add lingui/skills --skill enhanced-message-context -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/lingui/skills/tree/HEAD/skills/enhanced-message-context/SKILL.md

## Когда брать
- выбрать, каким строкам Lingui нужен комментарий для переводчика
- объяснить переводчику, что значит подпись «Post» в контексте продукта
- пометить группу однотипных строк одной директивой `lingui-set`
- найти в извлечённом `.po`-каталоге записи без `#.`
- не трогать строки в вендорных компонентах `components/ui/**`

## Примеры запросов агенту
- Добавь комментарии переводчику к строкам в `src/pages/settings.tsx`
- Проверь `src/locales/en/messages.po`: какие записи без `#.` относятся к коротким подписям?
- Перепиши `t`-шаблон для кнопки «Delete» в объектную форму с `comment`

## Похожие
- [jta](https://affpapa.org/nevibecode/skills/jta.md) — скилл · ★ 24 у репозитория
- [localization-engineer](https://affpapa.org/nevibecode/skills/localization-engineer.md) — скилл · 163 установки
- [localization-testing](https://affpapa.org/nevibecode/skills/localization-testing.md) — скилл · 137 установок
- [oma-translation](https://affpapa.org/nevibecode/skills/oma-translation.md) — скилл · ★ 1472 у репозитория
- [i18n-specialist](https://affpapa.org/nevibecode/agents/i18n-specialist.md) — субагент · ★ 489 у репозитория
- [blog-localize](https://affpapa.org/nevibecode/skills/blog-localize.md) — скилл · 2600 установок

Из того же набора: [lingui/skills](https://affpapa.org/nevibecode/by/lingui/skills.md) — 6 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
