stop-describing-ui — скилл
Скилл вычищает пояснительные тексты из интерфейса: девять правил, показ до и после, точные глаголы вместо общих.
- 93 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Только инструкции по тексту интерфейса, исполняемого кода в скилле нет
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/stop-describing-uiОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Только инструкции по тексту интерфейса, исполняемого кода в скилле нет
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
stop-describing-ui применяется, когда агент пишет, правит или проверяет тексты интерфейса: заголовки, пустые состояния, подписи кнопок, описания переключателей, подсказки, диалоги, баннеры, уведомления о разрешениях и онбординг. Основная мысль скилла: интерфейс показывает, что можно сделать, и обходится без самопояснений, ведь каждое предложение читатель обязан прочесть до действия. Девять правил: называть действие вместо описания функции; брать точные глаголы вроде «Подключить репозиторий» вместо «Новый»; оставлять только самое важное последствие; молчать о поведении бэкенда; не объяснять отмену, когда ее делает тот же элемент; не повторять то, что уже говорит страница; не сообщать о несуществующем; показывать способ включения на экране; подкреплять текст другими средствами. При проверке агент проходит каждую строку и выдает результат в виде «до и после».
Для кого. Дизайнерам продуктов и разработчикам интерфейсов, которые пишут микротексты с помощью агента и хотят короче и точнее.
Подходит, если
- Пустое состояние страницы пересказывает функцию, и его надо заменить одним точным действием.
- В окне подтверждения перечислены все последствия, а читателю хватит самого важного.
- Описания переключателей в настройках разрослись, и интерфейс пора разгрузить.
- Нужен разбор всех строк экрана с выводом «до и после».
Не подходит, если
- Нужны развернутые справочные статьи или документация: скилл сокращает тексты интерфейса.
- Пользователь сделает реальную ошибку без пояснения: правило оставляет такие предложения.
- Юридический или регуляторный текст должен остаться полным.
Пример запроса к агенту
Просмотри тексты экрана настроек по stop-describing-ui и покажи таблицу до и после.Ограничения
Скилл состоит из одного `SKILL.md` с правилами и примерами до и после, исполняемого кода и сторонних зависимостей в нем нет. Он задает редакторскую позицию: сокращать тексты, пока пользователь не начнет делать ошибки без пояснения. Применять правила слепо нельзя, юридические, платежные и тревожные сообщения часто требуют полных формулировок. В репозитории примеры написаны на английском, для русского интерфейса принципы переносятся, а примеры придется подбирать. Версий под отдельные агенты нет, ставится через `npx skills add`.
Как отключить. Удалите папку скилла из каталога скиллов агента или выполните удаление через `npx skills`. Правки текстов, уже внесенные агентом, остаются в проекте.
Частые вопросы
Что говорит первое правило?
Называть действие вместо описания функции: заголовок, элемент и его подпись уже объясняют, для чего экран.
Как менять общие глаголы?
Берите точный глагол с объектом. «Новый» становится «Подключить репозиторий», а «Управление» и «Настроить» заменяются конкретными действиями.
Что делать с последствиями действия?
Оставьте одно главное. Следствия из него читатель выведет сам, например выключенные автоответы, очевидно, останавливают и бронирование.
Как выглядит результат проверки?
Агент проходит каждую строку, применяет правила и показывает пары «до» и «после».
Как поставить?
Командой `npx skills add artouc/stop-describing-ui`. Правила лежат в `skills/stop-describing-ui/SKILL.md`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл для Codex: три разных визуальных концепта, ревью по скриншотам и чистка лишнего, чтобы интерфейс не выглядел шаблонно.
Скилл дизайна интерфейсов: арт-дирекция под продукт, общий DESIGN.md, токены, проверка верстки и доступности в браузере.
Скилл запрещает агенту типовой интерфейс с плавающими карточками, градиентами и стеклом и задает обычные размеры, радиусы и тени как у Linear
Скилл для дизайна интерфейсов: три разных направления рядом, выбор одного и доводка по настоящим скриншотам в Claude Code, Codex и других агентах
Скилл и CLI для интерфейсов: создание, редизайн и проверка с учетом аудитории, контента и фирменного стиля продукта
Детали, от которых интерфейс приятнее
make-interfaces-feel-better
Скилл о мелких деталях интерфейса: анимации, типографика, иконки, тени, скругления, оптическое выравнивание и области нажатия
Коротко о README
README коротко показывает команду установки, ссылку на правила и картинки до и после. Основное содержание лежит в файле SKILL.md.
Бейдж для README
Исходный SKILL.md
--- name: stop-describing-ui description: Strip explanatory copy out of user interfaces. Use when writing, editing, or reviewing any UI text, including headings, empty states, button labels, toggle and setting descriptions, helper text, dialogs, banners, permission notices, and onboarding --- # Stop describing UI An interface shows what the user can do. It does not explain itself. Every sentence is something the user has to read before acting, so keep a sentence only when the user would make a real mistake without it.