ux-writingpor content-designer

UX Writing Skill.

Uma skill Claude Code e Codex para pesquisa de UX: microtextos centrados no usuário e acessíveis: botões, rótulos, erros, formulários, onboarding.

UX & Research

Baixar OpenDesign Ver guia de uso

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

Metadados e títulos de seção lidos do arquivo upstream em 14/09/2026 · 15.313 caracteres no total

01 O que faz

O que a Skill ux-writing faz no Claude Code e no Codex

Resumo, fluxo de trabalho e resultados, todos lidos do SKILL.md do skill.

Do SKILL.mdLido em 14/09/2026 · não é uma execução registrada

Nos termos do próprio skill

Um guia prático para escrever e editar microcopy em produtos digitais: botões, rótulos, títulos, mensagens de erro, notificações, formulários, onboarding, estados vazios, mensagens de sucesso e textos de ajuda. Cada string é avaliada com base em quatro padrões de qualidade — propositiva, concisa, conversacional e clara — e cada tipo de elemento tem um padrão, como [Verbo] [objeto] para botões e [O que falhou].

[Por quê/contexto]. [O que fazer]. para erros. A voz é tratada como uma personalidade de marca fixa, enquanto o tom varia entre usuários frustrados, confusos, confiantes, cautelosos e bem-sucedidos. A skill adiciona regras de acessibilidade, benchmarks de frase e caracteres baseados em pesquisa, um processo de edição de quatro fases e arquivos de referência para gráficos de voz, usabilidade de conteúdo e Figma MCP.

O que ele produz

O próprio texto da interface em botões, rótulos, mensagens de erro, notificações, formulários e elementos relacionados.
Um gráfico de voz do produto, construído com references/voice-chart-template.md, mapeando conceitos de marca a características de voz e exemplos de fazer/não fazer.
Mensagens de erro escritas a partir de templates/error-message-template.md, um template preenchível para mensagens de erro eficazes.
Um fluxo de onboarding desenhado a partir de templates/onboarding-flow-template.md, o framework para experiências de onboarding claras.

Veja o exemplo de prompt ↗

Como funciona

01
Comece pelo Contexto
O primeiro passo é entender os objetivos do usuário, os objetivos de negócio, as restrições técnicas e o estado emocional do usuário antes de qualquer rascunho começar.
02
Rascunhe a partir da Fala
Comece com o que você diria em voz alta, aplique o padrão do elemento, avalie voz e tom e, depois, priorize a informação importante.
03
Edite em Quatro Passagens Ordenadas
O arquivo prescreve quatro fases, executadas em ordem: propositiva, concisa, conversacional, clara, cada uma com suas próprias perguntas de verificação.
04
Combine o Tom com o Momento
O tom é adaptado conforme o estado emocional do usuário — frustrado, confuso, confiante, cauteloso, bem-sucedido — enquanto a voz permanece constante.
05
Teste e Meça
Revise com a equipe, teste com usuários quando possível e, então, meça a conclusão da tarefa e a compreensão, em vez de opiniões.

02 Encontre o ideal para você

Quando Usar o ux-writing Skill

Use o ux-writing skill no Claude Code ou Codex quando o trabalho for pesquisa UX deste tipo. Adequação e limites abaixo são extraídos do próprio arquivo do skill.

Boa Combinação

Escrever textos novos para elementos de interface: botões, rótulos, títulos, mensagens e formulários.
Editar textos de UX existentes que já foram lançados, mas que ficaram mal escritos.
Auditar o conteúdo de um produto quanto à consistência e à usabilidade entre telas.
Escrever mensagens de erro, notificação e sucesso que expliquem e ajudem a recuperar.
Estabelecer a voz e o tom de um produto, ou projetar fluxos de onboarding e conversacionais.

Conheça os Limites

Não funciona no ChatGPT — o arquivo afirma que ele roda com Codex CLI/IDE e que o ChatGPT não pode instalar ou usar skills.
Explicações vagas de falha, como "Algo deu errado", estão listadas como algo a evitar.
Humor excessivamente espirituoso está fora em contextos sérios.

O Que Fornecer

O estado emocional e os riscos do usuárioO tom é escolhido a partir de como o usuário se sente e de quanto está em jogo — uma mudança de tema de baixo risco se lê de forma diferente de excluir uma conta.
Restrições de acessibilidadeSe o contexto visual é suficiente para um elemento, ou se são necessários rótulos explícitos e rótulos ARIA para tecnologia assistiva.

03 Dentro da skill

Regras que a Skill ux-writing Dá ao Claude Code e ao Codex

8 instruções concretas, padrões e limites que o SKILL.md define para o agente — a parte do arquivo que muda o resultado.

Linhas de 40-60 Caracteres
As linhas de texto de interface devem ter de 40 a 60 caracteres, o intervalo máximo de legibilidade que o arquivo define.
Botões: 2-4 Palavras
Rótulos de botões e CTAs devem ter de 2 a 4 palavras, com 6 palavras como limite absoluto.
Linguagem Simples por Público
Escreva em um nível de leitura de 7ª série para o público geral e de 10ª série para contextos profissionais.
Voz Ativa em 85% do Tempo
Cerca de 85% do texto deve estar na voz ativa.
Erros Seguem uma Ordem Fixa
O texto de erro indica o que falhou, depois o motivo ou o contexto, e então o que fazer — nessa ordem.
Nunca Culpe o Usuário
O texto de erro reconhece o problema sem culpar a pessoa que o lê.
Nunca Só a Cor
O significado nunca é transmitido apenas pela cor; os indicadores visuais são combinados com texto.
Mensagens de Erro: 12-18 Palavras
Uma mensagem de erro, incluindo a solução, deve ficar entre 12 e 18 palavras.

04 Coloque em prática

Instalar ux-writing no Claude Code ou Codex

Um comando npx skills add, depois uma primeira tarefa no seu agente e uma checklist para o resultado.

Adicionar ux-writing ao Claude Code, Codex ou seu agente

Rode no seu projeto; o instalador pergunta a qual agente adicioná-lo.

Terminal

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

Formato genérico da CLI skills para SKILL.md; o repositório pode documentar seu próprio caminho.

Dê à Skill uma Primeira Tarefa de Pesquisa de UX

Escrito nos próprios termos do skill; substitua as partes entre colchetes pelo seu material.

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.

Fonte: escrito a partir do SKILL.md nos próprios termos do skill.

Verifique o Primeiro Resultado

O que o próprio SKILL.md diz sobre como é um resultado correto:

Leia o texto em voz alta e verifique se você realmente diria dessa forma.
Passe os textos por uma ferramenta de legibilidade; os arquivos Hemingway Editor e a pontuação Flesch-Kincaid.
Verifique os parâmetros de compreensão: 8 palavras ou menos alcançam 100% de compreensão, 14 palavras ou menos alcançam 90%.
Percorra references/content-usability-checklist.md, a checklist fornecida para avaliar a qualidade do texto de UX.
Faça a equipe revisar e testar com usuários, medindo a conclusão de tarefas e a compreensão em vez de gosto pessoal.
Para acessibilidade, confirme que os erros estão estruturados de modo que o erro e o rótulo do campo sejam anunciados juntos por um leitor de tela.

No OpenDesign importe ux-writing a partir do link do SKILL.md: Plugins → Add → Skill → Import from link, depois selecione-o na barra superior.

Baixar OpenDesign Ler o quickstart

05 Código aberto, rastreável

Fonte, Licença e Verificação

De onde vêm os fatos desta página e quando foram verificados pela última vez.

Author: content-designer
Repository: github.com/content-designer/ux-writing-skill Branch main
Arquivo da skill: SKILL.md Checksum do conteúdo registrado na verificação; commit 98cacde
License: MIT De LICENSE.
Estrelas do repositório: 168 Snapshot do GitHub tirado em 14/09/2026 para todo o repositório content-designer/ux-writing-skill. Não é uma avaliação ou contagem de uso para ux-writing.
Verificado pelo OpenDesign: 14/09/2026 Arquivo de origem, caminho, texto da licença e contagem de estrelas foram verificados. Não integrado ao OpenDesign principal (verificado em 28/08/2026); uma execução ao vivo não foi registrada nesta página.

Dentro do SKILL.md

Quando Usar Este SkillSeis gatilhos: escrever ou editar textos de interface, mensagens, fluxos conversacionais, voz, auditoria de conteúdo.
Princípios Fundamentais de UX WritingOs quatro padrões de qualidade, além de concisão, clareza, tom conversacional e práticas centradas no usuário.
Padrões de Texto de UXFormatos e exemplos para títulos, botões, quatro tipos de erro, mensagens de sucesso, estados vazios, formulários e notificações.
Voz e TomConstrução de uma voz constante; ajuste do tom conforme o estado emocional do usuário e o tipo de conteúdo.
Processo de EdiçãoQuatro passagens ordenadas — propositiva, concisa, conversacional, clara — cada uma com suas perguntas de verificação.
Fluxo de TrabalhoEntenda o contexto, redija, edite de forma iterativa pelas quatro fases e, depois, teste e meça.
Acessibilidade na Redação de UXRequisitos de leitor de tela, cognitivos, multimodais e de linguagem simples, com exemplos de padrões ruins e bons.
Parâmetros de Referência de Texto de UXMetas de frase e caractere por elemento, taxas de compreensão e níveis de leitura, com ferramentas de teste.
Erros Comuns a EvitarOnze antipadrões, da voz passiva e rótulos genéricos a textos de link inacessíveis.
Referência RápidaLembretes em uma linha sobre sentence case, botões no imperativo, foco no usuário, verbos específicos e priorização de informação.
RecursosNove arquivos incluídos: guia de acessibilidade, tabela de voz, checklist de usabilidade, exemplos de padrões, templates e integração com Figma.

A Descrição da Própria Skill

"Crie textos de interface (microcopy) acessíveis e centrados no usuário para produtos digitais, incluindo botões, rótulos, mensagens de erro, notificações, formulários, onboarding, estados vazios, mensagens de sucesso e textos de ajuda. Use ao escrever ou editar qualquer texto que apareça em apps, sites ou interfaces de software, projetar fluxos conversacionais, estabelecer diretrizes de voz e tom, auditar conteúdo de produto para consistência e usabilidade, revisar strings de UI ou melhorar textos de interface existentes. Aplica melhores práticas de UX writing baseadas em quatro padrões de qualidade — intencional, conciso, conversacional e claro. Inclui diretrizes de acessibilidade, benchmarks baseados em pesquisa (comprimento de frase, taxas de compreensão, níveis de leitura), padrões de erro expandidos, frameworks de adaptação de tom e materiais de referência abrangentes."

Descrição do front-matter do SKILL.md. O arquivo completo tem cerca de 15.313 caracteres. Leia o arquivo completo no GitHub.

06 Antes de instalar

Perguntas Sobre o Skill ux-writing

As respostas vêm do SKILL.md conforme lido em 2026-09-14, e não de uma execução registrada.

Quais agentes podem executar este skill?

Foi escrito para Claude, Codex, Cursor e qualquer outro agente compatível com a especificação de agent skills. O ChatGPT é explicitamente excluído — ele não pode instalar nem usar skills.

Posso usá-lo em textos que já existem?

Sim. O skill abrange a edição de textos de UX já existentes, a revisão de strings de UI e a auditoria de conteúdo de produto quanto à consistência e usabilidade, não apenas a redação do zero.

Ele aborda acessibilidade?

Sim. A escrita acessível tem sua própria seção, abrangendo otimização para leitor de tela, acessibilidade cognitiva, comunicação multimodal e linguagem simples, com um contraste de cor mínimo WCAG AA de 4,5:1.

UX Writing

Execute ux-writing em uma tarefa real de pesquisa UX.

Baixe o OpenDesign, importe ux-writing a partir do link SKILL.md, cole o prompt acima e leia o plano antes do resultado.

Baixar OpenDesign Ver todas as skills