# stop-describing-ui

Скилл вычищает пояснительный текст из UI: заголовки, пустые состояния, подписи кнопок, подсказки и онбординг. Пригодится, когда экран объясняет себя вместо того, чтобы показывать действие.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 717 установок · ★ 87
- Автор: artouc
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/artouc/stop-describing-ui/tree/HEAD/skills/stop-describing-ui/SKILL.md
- Обновлён: 2026-10-11
- HTML: https://affpapa.org/nevibecode/skills/stop-describing-ui

## Что делает

Правило простое: интерфейс показывает, что пользователь может сделать, и не рассказывает о себе. Каждое предложение — это то, что человек обязан прочитать до действия. Поэтому фраза остаётся только там, где без неё пользователь реально ошибётся.

Скилл работает в двух режимах. Когда вы пишете текст, он применяет правила по ходу. Когда проверяете готовый интерфейс, он проходит по каждой строке и выдаёт результат в виде «до» и «после». Правил девять: не описывать фичу, а называть действие; брать точный глагол вместо `New`, `Create`, `Manage`, `Set up`, `Configure`; оставлять только самое критичное последствие; не рассказывать про хранение данных, логи и фоновые процессы; не объяснять отмену, если её делает тот же контрол; не повторять то, что уже сказано в заголовке страницы; не сообщать о том, чего нет; показывать кнопку включения вместо инструкции, как включить; разбивать абзац на строки с иконками и не ставить `->`, `>`, `|`, `→` или `:` разделителями.

Необратимые последствия — удаление данных, списание денег, уведомление клиентов — остаются всегда. Ограничение, на котором пользователь иначе попробует и получит отказ, тоже остаётся: одной короткой строкой с иконкой. Если после чек-листа не осталось ничего, так и должно быть — пустой слот подсказки лучше предложения-заглушки.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add artouc/stop-describing-ui --skill stop-describing-ui -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add artouc/stop-describing-ui --skill stop-describing-ui -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add artouc/stop-describing-ui --skill stop-describing-ui -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install artouc/stop-describing-ui stop-describing-ui
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add artouc/stop-describing-ui --skill stop-describing-ui -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/artouc/stop-describing-ui --path skills/stop-describing-ui
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add artouc/stop-describing-ui --skill stop-describing-ui -a opencode
```

### Claude.ai

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

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

## Когда брать
- убрать пояснительный текст из пустых состояний
- заменить расплывчатые подписи кнопок на точные глаголы
- сократить описание настроек до одного последствия
- вынести инструкцию «как включить» в кнопку или тумблер
- разбить абзац подсказки на строки с иконками

## Примеры запросов агенту
- проверь тексты этого экрана по правилам stop-describing-ui и покажи до и после
- перепиши подписи кнопок и тумблеров в настройках, убери описания фич
- почисти онбординг от пояснений, оставь только действия

## Похожие
- [impeccable](https://affpapa.org/nevibecode/skills/impeccable.md) — скилл · 361300 установок
- [uizze-ui](https://affpapa.org/nevibecode/skills/uizze-ui.md) — скилл · 144000 установок
- [ux-designer](https://affpapa.org/nevibecode/skills/ux-designer.md) — скилл · 1600 установок
- [audit-ai-design-slop](https://affpapa.org/nevibecode/skills/audit-ai-design-slop.md) — скилл · 1200 установок
- [design-better](https://affpapa.org/nevibecode/skills/design-better.md) — скилл · 1100 установок
- [nielsen-usability-heuristics](https://affpapa.org/nevibecode/skills/nielsen-usability-heuristics.md) — скилл · 976 установок

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