# ux-writing

Скилл задаёт правила для пользовательских строк и документации: вывод CLI, ошибки, справка, README, комментарии и заголовки. Пригодится, когда правишь копирайт или структуру доков.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 224
- Автор: scarletkc
- Лицензия: Apache-2.0 · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/scarletkc/agents/tree/HEAD/skills/ux-writing/SKILL.md
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/skills/scarletkc-ux-writing

## Что делает

Скилл собирает правила оценки текста, который видит пользователь. Это вывод статуса и диагностики, сообщения об ошибках и справка, структура README и документации, комментарии в коде, заголовки, а также сгенерированные отчёты, презентации и выгрузки. Каждое правило идёт с контрпримером из реального дефекта на ревью — потому что смысл здесь именно в рассуждении, а не в списке запретов.

Внутри — разделы по статусному выводу, ошибкам и документации. Например, статус должен показывать действующие значения, а не сохранённые: то, что реально применится при следующем запуске, с учётом переменных окружения и слоёв конфига. Диагностика обязана оставаться правдивой при сбое: если один слой конфигурации не загрузился, берётся наиболее полное состояние, которое ещё грузится, а не пустые значения по умолчанию. Машиночитаемый вывод — контракт, поэтому украшения и пометки в него не попадают.

Документация делится по ответственности: у каждого факта одно каноническое место, остальные страницы ссылаются на него. Обоснование решений живёт в отдельной записи, а не в инструкции по использованию, иначе шаги уезжают под сгиб, а аргументы устаревают первыми. Скилл подключается к Claude, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode; для Windsurf (Devin Desktop) указан только путь к файлу скилла, команды установки нет.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scarletkc/agents --skill ux-writing -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scarletkc/agents --skill ux-writing -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scarletkc/agents --skill ux-writing -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install scarletkc/agents ux-writing
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add scarletkc/agents --skill ux-writing -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/scarletkc/agents --path skills/ux-writing
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add scarletkc/agents --skill ux-writing -a opencode
```

### Claude.ai

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

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

## Когда брать
- привести вывод статуса к действующим значениям с учётом окружения
- не дать диагностике соврать при сбое одного слоя конфига
- развести дублирующиеся описания одного факта по страницам
- убрать из машиночитаемого вывода пометки и украшения
- проверить диф, который трогает тексты и документацию

## Примеры запросов агенту
- Проверь сообщения об ошибках в этом модуле: что случилось, где и что делать дальше
- Разложи README по ответственности и скажи, какой странице принадлежит каждый факт
- Посмотри диф: не попали ли в JSON-вывод лишние пометки

## Похожие
- [grill-with-docs](https://affpapa.org/nevibecode/skills/grill-with-docs.md) — скилл · 1219756 установок
- [skill-creator](https://affpapa.org/nevibecode/skills/skill-creator.md) — скилл · 414180 установок
- [setup-matt-pocock-skills](https://affpapa.org/nevibecode/skills/setup-matt-pocock-skills.md) — скилл · 1052851 установка
- [handoff](https://affpapa.org/nevibecode/skills/handoff.md) — скилл · 1038491 установка
- [triage](https://affpapa.org/nevibecode/skills/triage.md) — скилл · 990453 установки
- [domain-modeling](https://affpapa.org/nevibecode/skills/domain-modeling.md) — скилл · 876391 установка

## Другие версии с тем же именем
- [ux-writing · content-designer](https://affpapa.org/nevibecode/skills/ux-writing.md) — 2700 установок
- [ux-writing · owl-listener](https://affpapa.org/nevibecode/skills/owl-listener-ux-writing.md) — 2200 установок
- [ux-writing · plugin87](https://affpapa.org/nevibecode/skills/plugin87-ux-writing.md) — 517 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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