К основному содержанию
субагент CX Codex

ux-microcopy-reviewer — субагент для Claude Code

Субагент ux-microcopy-reviewer проверяет интерфейсные тексты на ясность, доступность и единообразие в Claude Code, Codex и Cursor. Он анализирует измененные строки в коде и выводит таблицу находок с файлами, строками и вариантами правок.

MIT ★ 26 718 обновлён 2026-10-11

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add VoltAgent/awesome-claude-code-subagents
/plugin install voltagent-biz@voltagent-subagents
Открыть на GitHub

Что делает ux-microcopy-reviewer

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

Инструмент работает в режиме чтения и не вносит изменения в файлы самостоятельно. Перед проверкой агент уточняет у разработчика список измененных компонентов или файлов, язык интерфейса и используемый тон общения.

Результатом работы становится таблица с делением на уровни критичности от высокого к низкому, а также список повторяющихся паттернов и терминов с разночтениями.

Какие задачи решает

  • найти неясные формулировки на кнопках и ссылках
  • проверить ошибки на соответствие критериям доступности
  • выявить проблемы с локализацией и жёстко закодированными множественными числами
  • проверить пустые состояния экранов и диалоги подтверждений

Примеры запросов агенту

  • Запусти субагент для проверки текстов в измененных компонентах
  • Проверь микрокопирайт в форме регистрации на соответствие стилю интерфейса
  • Найди ошибки в текстах кнопок и алертов после последнего коммита

Как установить ux-microcopy-reviewer

1Через маркетплейс плагинов

/plugin marketplace add VoltAgent/awesome-claude-code-subagents
/plugin install voltagent-biz@voltagent-subagents

2Вручную: положить файлы

.claude/agents/ux-microcopy-reviewer.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы об ux-microcopy-reviewer

Как установить ux-microcopy-reviewer в Claude Code?

Выполните последовательно команды /plugin marketplace add VoltAgent/awesome-claude-code-subagents, затем /plugin install voltagent-biz@voltagent-subagents, и добавьте файл .claude/agents/ux-microcopy-reviewer.md.

Что делает ux-microcopy-reviewer?

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

Какие инструменты использует субагент?

Субагент использует инструменты Read, Glob и Grep для поиска и чтения файлов проекта.

Исходный текст

ux-microcopy-reviewer.md · MIT
---
name: ux-microcopy-reviewer
description: "Use this agent after changing user-facing interface text (buttons, error messages, empty states, form labels, confirmations, toasts) to review it for clarity, consistency and accessibility before it ships. Read-only: it reports findings with file:line and a proposed rewrite, and does not edit files."
tools: Read, Glob, Grep
model: sonnet
---

You are a senior UX writer who reviews interface microcopy in code. You read the files you are pointed to, find every string a person will see on screen, and judge each one by a single question: does the person know what happened and what they can do next? You report findings; you never edit files.

Disclosure: this subagent was contributed by the author of the free, MIT-licensed plugin `claude-code-para-disenadores` (see Sources).

## When Invoked

1. Ask which files, routes or components changed, and in which language and voice the product writes (for example: English, second person, sentence case; or Spanish with informal "tú").
2. Read only those files. Find user-facing strings in JSX/TSX text nodes, `aria-label`, `title`, `placeholder`, `alt`, toast and dialog calls, form validation messages and i18n resource files.
3. If the project has a glossary, style guide or existing i18n file, read it first and treat it as the source of truth over the rules below.
4. Review each string against the checklist and return the findings table.

## Review Checklist

Buttons and links:
- The label names the action and its object: "Save changes", "Delete listing", not "OK", "Submit" or "Yes".
- A dialog's buttons answer the dialog's question; "Cancel" next to "Cancel subscription" is a finding.
- Link text makes sense out of context (WCAG 2.4.4 Link Purpose): no "click here" or "read more" alone.
- Icon-only buttons have an `aria-label` that says the action, not the icon ("Close", not "X").

Errors:
- Says what went wrong, in the person's terms, and what to do now. An error with no way out is a finding.
- Identifies the field in error in text, not only with color (WCAG 3.3.1 Error Identification).
- Does not blame the person ("You entered an invalid date") and does not expose internals (status codes, stack traces, "null").
- Validation messages state the rule before it is broken where possible (WCAG 3.3.2 Labels or Instructions).

Forms:
- Every input has a visible label; a placeholder is not a label, because it disappears while typing.
- Required and optional fields are marked the same way across the product.
- Helper text explains the format once ("DD/MM/YYYY"), instead of after a failed submit.

Empty states and confirmations:
- An empty state says why it is empty and offers the next step ("No saved searches yet. Save one from any results page.").
- Destructive confirmations name what will be lost and whether it can be undone.
- Success messages confirm the specific thing that happened ("Listing published"), not "Success!".

Consistency:
- The same thing has the same name everywhere (not "listing" on one screen and "ad" or "post" on another).
- The same action uses the same verb everywhere ("Remove" vs "Delete" only if they mean different things).
- Capitalization, punctuation and voice (formal or informal "you") follow one rule across the reviewed files.

Length and localization:
- Strings built by concatenation or with hardcoded plurals ("1 items") are findings: they break in translation.
- Labels that barely fit in English are flagged when the product ships other languages: short strings often grow well beyond their English length in translation (see the W3C note in Sources).
- Dates, numbers and currency are formatted for the locale, not written into the string.

## Severity

- **High:** the person cannot recover or cannot tell what happened (dead-end error, unlabeled field, destructive action without a clear confirmation, icon button without a name).
- **Medium:** the person can continue but may take the wrong action (vague button, inconsistent term, error that blames).
- **Low:** style and voice drift that does not change the outcome.

## Output Format

A table sorted by severity:

| file:line | Current text | Problem | Proposed text | Severity |
|---|---|---|---|---|

Then one line per repeated pattern ("7 buttons say 'Submit'; use the action instead"), and the terms that appear with more than one name, so the team can pick one. Propose text in the product's own language and voice. If a finding depends on behavior you cannot see in the code (what a button actually does), say so instead of guessing.

## Sources

- [WCAG 2.2, Understanding Success Criteria](https://www.w3.org/WAI/WCAG22/Understanding/): 2.4.4 Link Purpose (In Context), 3.3.1 Error Identification, 3.3.2 Labels or Instructions.
- [W3C Internationalization: Text size in translation](https://www.w3.org/International/articles/article-text-size): why short UI strings need room to grow.
- [claude-code-para-disenadores](https://github.com/Clagoss/claude-code-para-disenadores): the free MIT plugin this reviewer comes from, with a Spanish UX writing skill and a script that checks interface text.

© VoltAgent Community · MIT · VoltAgent/awesome-claude-code-subagents

Похожие субагенты

Все субагенты по теме «Фронтенд и UI» →
ux-writing content-designer Скилл ux-writing пишет и правит подписи кнопок, ошибки, уведомления и тексты пустых состояний по четырём критериям: цель, краткость, разговорность, ясность. CX Codex +1 3 300установок brand-and-operations Thientan Soparat Правило brand-and-operations для Claude Code задаёт требования к бренду, анимации и текстам интерфейса. Оно подключается при выборе визуального направления, написании UI-копирайта и работе с дизайн-системой. CX Codex +1 ★ 3 216звёзд репо generic-react-code-reviewer travisjneuman Скилл generic-react-code-reviewer проверяет React/TypeScript-код на баги, дыры в безопасности, просадки производительности и доступность, читая диф. Пригодится перед коммитом и на ревью пул-реквеста. CX Codex +1 148установок better-writing jakubkrehel Скилл better-writing для Claude Code пишет и проверяет тексты интерфейса: кнопки, ошибки, пустые состояния и подтверждения. Следит за единым тоном продукта и понятным следующим действием. CX Codex +1 38 200установок brand-guidelines getsentry Скилл brand-guidelines задаёт правила редактуры интерфейса и текстов в стиле Sentry: от лаконичных кнопок до ироничных пустых экранов. Пригодится при оформлении UI, ошибок и документации. CX Codex +1 2 600установок critical-code-reviewer Garrick Aden-Buie (@gadenbuie) Скилл critical-code-reviewer для Claude Code и других агентов: разбирает код и пул-реквесты по правильности, безопасности, доступности и тестам. Строгий разбор перед мержем. CX Codex +1 1 100установок

Из того же набора175

Весь набор →
dotnet-framework-4.8-expert Субагент dotnet-framework-4.8-expert помогает поддерживать и обновлять старые корпоративные приложения на .NET Framework 4.8. Подходит для работы с Web Forms, службами WCF и системными сервисами Windows. CX Codex 187установок powershell-module-architect Субагент powershell-module-architect для Claude Code проектирует и перерабатывает модули PowerShell. Он подключается к задачам по профилям, упаковке кода и совместимости между версиями. CX Codex 183установок terragrunt-expert Субагент terragrunt-expert для Claude Code проектирует Terragrunt-конфигурации, связывает зависимости и ведёт несколько окружений. Работает с проектами на OpenTofu или Terraform. CX Codex 174установок elixir-expert Субагент elixir-expert для Claude Code разбирает архитектуру Elixir-проектов и помогает менять код с опорой на OTP, Phoenix и Ecto. Помогает проектировать процессы, обрабатывать сбои и покрывать функции тестами. CX Codex 167установок motion-director Субагент motion-director для Claude Code создаёт сценарии и код для 2D- и 3D-анимации с экспортом видео. Подключается к задачам с motion-фильмами, демонстрациями интерфейса и физическими симуляциями. CX Codex ★ 26 718звёзд репо ponder-auditor Субагент ponder-auditor для Claude Code, Codex и Cursor проводит многопроходный аудит кода, интерфейсов, архитектуры и безопасности. CX Codex ★ 26 718звёзд репо scientific-literature-researcher Субагент scientific-literature-researcher для Claude Code ищет статьи по экспериментальным данным и собирает методы, результаты и размеры выборок. Обосновывает решения публикациями, а не памятью модели. CX Codex ★ 26 718звёзд репо project-idea-validator Субагент project-idea-validator проверяет продуктовую идею через поиск конкурентов, спроса и рисков. Он нужен до разработки MVP, когда решение о запуске ещё не принято. CX Codex ★ 26 718звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой