ux-writingавтор content-designer

UX Writing Skill.

Скилл Claude Code и Codex для UX-исследований: микротексты, ориентированные на пользователя и доступность: кнопки, метки, ошибки, формы, онбординг.

UX и исследования

Скачать OpenDesign Инструкция по использованию

content-designer/ux-writing-skill · SKILL.mdSKILL.md

--- name: ux-writing description: Create user-centered, accessible interface copy (microcopy) for digital products including buttons, labels, error messages, notifications, forms, onboarding, empty states, success messages, and help text. Use when writing or editing any text that appears in apps, websites, or software interfaces, designing conversational flows, establishing voice and tone guidelines, auditing product content for consistency and … --- ## When to Use This Skill ## Core UX Writing Principles ## UX Text Patterns ## Voice and Tone ## Editing Process ## Workflow

Метаданные и заголовки разделов прочитаны из исходного файла 2026-09-14 · 15 313 символов полностью

01 Что делает

Что делает Skill ux-writing в Claude Code и Codex

Сводка, рабочий процесс и результаты — всё прочитано из SKILL.md этого skill.

Из SKILL.mdПрочитано 14.09.2026 · не запись выполнения

Словами самого skill

Рабочее руководство по написанию и редактированию микрокопии в цифровых продуктах: кнопки, подписи, заголовки, сообщения об ошибках, уведомления, формы, онбординг, пустые состояния, сообщения об успехе и справочный текст. Каждая строка оценивается по четырём стандартам качества — целенаправленность, краткость, разговорность и ясность — и для каждого типа элемента есть шаблон, например [Verb] [object] для кнопок и [What failed].

[Why/context]. [What to do]. для ошибок. Голос рассматривается как фиксированная фирменная индивидуальность, тогда как тон меняется в зависимости от того, расстроен пользователь, растерян, уверен, осторожен или добился успеха. Skill добавляет правила доступности, подтверждённые исследованиями ориентиры по длине предложений и символов, четырёхфазный процесс редактирования и справочные файлы для карт голоса, юзабилити контента и Figma MCP.

Что он выдаёт

Сам текст интерфейса — кнопки, подписи, сообщения об ошибках, уведомления, формы и связанные элементы.
Карта голоса продукта, построенная с помощью references/voice-chart-template.md, сопоставляющая концепции бренда с характеристиками голоса и примерами того, что делать и чего не делать.
Сообщения об ошибках, написанные по шаблонам из templates/error-message-template.md — заполняемому шаблону для эффективных сообщений об ошибках.
Поток онбординга, разработанный на основе templates/onboarding-flow-template.md — фреймворка для создания понятных сценариев онбординга.

Смотрите пример запроса ↗

Как это работает

01
Начинайте с контекста
Первый шаг — понять цели пользователя, бизнес-задачи, технические ограничения и эмоциональное состояние пользователя до начала работы над текстом.
02
Составляйте черновик на основе устной речи
Начните с того, что вы бы сказали вслух, примените паттерн элемента, взвесьте голос и тон, затем разместите важную информацию в начале.
03
Редактируйте в четыре последовательных прохода
Файл предписывает четыре фазы, выполняемые по порядку: целенаправленность, краткость, разговорность, ясность, — каждая со своими проверочными вопросами.
04
Подбирайте тон под момент
Тон подстраивается под эмоциональное состояние пользователя — раздражение, растерянность, уверенность, осторожность, успех, — при этом голос остаётся неизменным.
05
Тестируйте и измеряйте
Проведите обзор с командой, при возможности протестируйте с пользователями, затем измеряйте завершение задач и понимание, а не мнения.

02 Определите своё применение

Когда использовать ux-writing Skill

Используйте ux-writing skill в Claude Code или Codex, когда задача — UX-исследование такого типа. Возможности и ограничения ниже взяты из собственного файла навыка.

Хорошо подходит

Написание нового текста для элементов интерфейса: кнопок, подписей, заголовков, сообщений и форм.
Редактирование существующего текста интерфейса, который уже опубликован, но читается плохо.
Аудит контента продукта на предмет согласованности и удобства использования на всех экранах.
Написание сообщений об ошибках, уведомлений и об успехе, которые объясняют и помогают восстановиться.
Определение голоса и тона продукта, а также разработка сценариев онбординга и диалоговых потоков.

Знайте границы

Не будет работать в ChatGPT — в файле указано, что он запускается с Codex CLI/IDE и что ChatGPT не может устанавливать или использовать skills.
Расплывчатые объяснения сбоев, такие как «Что-то пошло не так», указаны как то, чего следует избегать.
Чрезмерно остроумный юмор неуместен в серьёзных контекстах.

Что предоставить

Эмоциональное состояние пользователя и уровень рискаТон выбирается на основе того, что чувствует пользователь и насколько высоки ставки — смена темы с низким риском читается иначе, чем удаление аккаунта.
Ограничения доступностиДостаточно ли визуального контекста для элемента, или нужны явные подписи и ARIA-метки для вспомогательных технологий.

03 Внутри скилла

Правила, которые skill ux-writing даёт Claude Code и Codex

8 конкретных инструкций, значений по умолчанию и ограничений, которые SKILL.md задаёт для агента — та часть файла, которая влияет на результат.

Строки длиной 40-60 символов
Строки текста интерфейса должны составлять 40-60 символов — это максимальный диапазон читаемости, установленный файлом.
Кнопки: 2-4 слова
Текст кнопок и CTA должен состоять из 2-4 слов, максимум — 6 слов.
Простой язык для аудитории
Пишите на уровне 7-го класса для общей аудитории и 10-го класса для профессионального контекста.
Активный залог в 85% случаев
Примерно 85% текста должно быть написано в активном залоге.
Фиксированный порядок в сообщениях об ошибках
Текст ошибки сначала сообщает, что произошло сбой, затем почему или в каком контексте, затем что делать — именно в этом порядке.
Никогда не обвиняйте пользователя
Текст ошибки признаёт проблему, не возлагая вину на того, кто её читает.
Никогда не используйте только цвет
Смысл никогда не передаётся только цветом; визуальные индикаторы всегда сопровождаются текстом.
Сообщения об ошибках: 12-18 слов
Сообщение об ошибке, включая решение, должно укладываться в 12-18 слов.

04 Применение

Установите ux-writing в Claude Code или Codex

Одна команда npx skills add, затем первая задача в вашем агенте и чек-лист для результата.

Добавьте ux-writing в Claude Code, Codex или ваш агент

Запустите в своём проекте; установщик спросит, какому агенту его добавить.

Terminal

npx skills add https://github.com/content-designer/ux-writing-skill --skill ux-writing

Общая форма CLI-команды skills для SKILL.md; репозиторий может документировать собственный путь.

Дайте скиллу первую задачу по UX-исследованию

Написано в терминах самого skill; замените части в квадратных скобках своим материалом.

Starter prompt

Write the microcopy for our [checkout] flow: the payment button label, the field labels, and the message a user sees when their card is declined. The user will be frustrated, so keep the tone empathetic and give a clear next step. Then run the four-phase edit and flag any line over 60 characters.

Источник: составлено по SKILL.md в терминах самого skill.

Проверьте первый результат

Что сам SKILL.md считает правильным результатом:

Прочитайте текст вслух и спросите себя, сказали бы вы это именно так.
Прогоните текст через инструмент проверки читаемости; файлы Hemingway Editor и оценка по Flesch-Kincaid.
Проверьте показатели понимания: 8 слов или меньше — 100% понимания, 14 слов или меньше — 90%.
Пройдитесь по references/content-usability-checklist.md — встроенному чек-листу для оценки качества UX-текста.
Дайте команде проверить и протестировать текст на пользователях, измеряя завершение задач и понимание, а не оценивая на вкус.
Для доступности убедитесь, что ошибки структурированы так, чтобы сама ошибка и подпись поля озвучивались вместе программой чтения с экрана.

В OpenDesign импортируйте ux-writing по ссылке из его SKILL.md: Plugins → Add → Skill → Import from link, затем выберите его в верхней панели.

Скачать OpenDesign Читать quickstart

05 Открытый исходный код, проверяемость

Источник, лицензия и проверка

Откуда взяты факты на этой странице и когда они были последний раз проверены.

Author: content-designer
Repository: github.com/content-designer/ux-writing-skill Ветка main
Файл skill: SKILL.md Контрольная сумма содержимого записана при верификации; коммит 98cacde
License: MIT Из LICENSE.
Звёзды репозитория: 168 Снимок GitHub от 14.09.2026 для всего репозитория content-designer/ux-writing-skill. Не является рейтингом или счётчиком использования для ux-writing.
Проверено OpenDesign: 2026-09-14 Исходный файл, путь, текст лицензии и количество звезд были проверены. Не входит в основной комплект OpenDesign (проверено 2026-08-28); живой запуск не был записан на этой странице.

Внутри SKILL.md

Когда использовать этот skillШесть триггеров: написание или редактирование текста интерфейса, сообщений, диалоговых сценариев, тона голоса, аудит контента.
Основные принципы UX-текстаЧетыре стандарта качества плюс лаконичность, ясность, разговорный тон и практики, ориентированные на пользователя.
Паттерны UX-текстаФорматы и примеры для заголовков, кнопок, четырёх типов ошибок, сообщений об успехе, пустых состояний, форм и уведомлений.
Голос и тонФормирование устойчивого голоса; изменение тона в зависимости от эмоционального состояния пользователя и типа контента.
Процесс редактированияЧетыре последовательных прохода — целесообразность, краткость, разговорность, ясность — каждый со своими проверочными вопросами.
Рабочий процессПонять контекст, составить черновик, итеративно редактировать по четырём фазам, затем протестировать и измерить.
Доступность в UX-текстахТребования для скринридеров, когнитивной доступности, мультимодальности и простого языка, с примерами удачных и неудачных паттернов.
Ориентиры для UX-текстаЦелевые значения по предложениям и символам для каждого элемента, показатели понимания и уровни читабельности с инструментами тестирования.
Распространённые ошибки, которых стоит избегатьОдиннадцать антипаттернов — от пассивного залога и обобщённых меток до недоступного текста ссылок.
Краткая справкаОднострочные напоминания о нижнем регистре предложений, повелительном наклонении кнопок, фокусе на пользователе, конкретных глаголах и вынесении главного вперёд.
РесурсыДевять готовых файлов: руководство по доступности, таблица голоса, чек-лист по удобству использования, примеры паттернов, шаблоны и интеграция с Figma.

Собственное описание skill

Создавайте ориентированные на пользователя доступные тексты интерфейса (микрокопи) для цифровых продуктов, включая кнопки, метки, сообщения об ошибках, уведомления, формы, онбординг, пустые состояния, сообщения об успехе и подсказки. Используйте для написания или редактирования любого текста, который появляется в приложениях, на веб-сайтах или в программном обеспечении, проектирования разговорных потоков, установления руководств по голосу и тону, аудита контента продукта на согласованность и юзабилити, проверки строк UI или улучшения существующих текстов интерфейса. Применяет лучшие практики UX-райтинга на основе четырёх стандартов качества — целенаправленность, лаконичность, разговорность и ясность. Включает рекомендации по доступности, основанные на исследованиях ориентиры (длина предложений, уровни понимания, уровни чтения), расширенные паттерны ошибок, фреймворки адаптации тона и полные справочные материалы.

Описание из front-matter SKILL.md. Полный файл содержит около 15 313 символов. Читать полный файл на GitHub.

06 Перед установкой

Вопросы о skill ux-writing

Ответы взяты из SKILL.md в редакции от 2026-09-14, а не из записанного запуска.

Какие агенты могут запускать этот skill?

Он написан для Claude, Codex, Cursor и любого другого агента, поддерживающего спецификацию agent skills. ChatGPT прямо исключён — он не может устанавливать или использовать skills.

Можно ли использовать его для текста, который уже существует?

Да. Skill охватывает редактирование существующего UX-текста, проверку строк интерфейса и аудит контента продукта на согласованность и удобство использования, а не только написание с нуля.

Охватывает ли он доступность?

Да. Доступное написание текста — отдельный раздел, охватывающий оптимизацию для скринридеров, когнитивную доступность, мультимодальную коммуникацию и простой язык, с минимальным контрастом цвета WCAG AA 4.5:1.

UX Writing

Запустите ux-writing на реальной задаче UX-исследования.

Скачайте OpenDesign, импортируйте ux-writing по ссылке SKILL.md, вставьте промпт выше и прочитайте план перед результатом.

Загрузить OpenDesign Все навыки

Терминал

npx skills add https://github.com/content-designer/ux-writing-skill --skill ux-writing

Что делает Skill ux-writing в Claude Code и Codex

Словами самого skill

Как это работает

Когда использовать ux-writing Skill

Хорошо подходит

Знайте границы

Что предоставить

Правила, которые skill ux-writing даёт Claude Code и Codex

Строки длиной 40-60 символов

Кнопки: 2-4 слова

Простой язык для аудитории

Активный залог в 85% случаев

Фиксированный порядок в сообщениях об ошибках

Никогда не обвиняйте пользователя

Никогда не используйте только цвет

Сообщения об ошибках: 12-18 слов