clarify

Visão Geral

O que é a clarify?

A skill clarify foi criada para ajudar equipes de UI e UX a identificar e aprimorar textos de interface que estejam confusos ou pouco claros. Isso inclui mensagens de erro, microcopy, rótulos e instruções que possam dificultar o entendimento do usuário. Ao revisar e reescrever esses elementos de forma sistemática, a clarify garante que seu produto comunique-se de maneira clara e eficaz com os usuários.

Para quem a clarify é indicada?

A clarify é ideal para designers de produto, redatores de UX, desenvolvedores de UI e qualquer pessoa responsável pelo texto da interface. Se seus usuários têm dificuldade com rótulos confusos, instruções ambíguas ou mensagens de erro pouco claras, essa skill oferece um método estruturado para melhorar a clareza e usabilidade.

Problemas que a clarify resolve

• Texto da interface com jargões técnicos ou pouco claros
• Instruções ambíguas ou que induzem ao erro
• Tom ou estilo inconsistente no microcopy
• Mensagens de erro que confundem em vez de ajudar
• Rótulos e prompts que deixam o usuário inseguro

Como Usar

Passos para Instalação

1. Instale a skill clarify com o comando:

   npx skills add https://github.com/pbakaus/impeccable --skill clarify

2. Comece pelo arquivo SKILL.md para uma visão geral do fluxo de trabalho e requisitos da clarify.

3. Consulte arquivos relacionados como README.md, AGENTS.md e metadata.json para mais contexto e detalhes de integração.

Orientações para o Fluxo de Trabalho

• Preparação Obrigatória:
  • Antes de fazer alterações, invoque /frontend-design para obter princípios de design e contexto. Se não houver contexto de design, execute /teach-impeccable primeiro.
  • Reúna informações sobre o nível técnico do público e seu estado mental ao interagir com a interface.
• Avalie o Texto Atual:
  • Identifique problemas como jargões, ambiguidades, voz passiva, textos longos demais, suposições, falta de contexto ou tom inadequado.
  • Entenda os objetivos, ações e limitações do usuário para cada elemento da interface.
• Planeje e Melhore:
  • Priorize quais textos precisam ser revisados com base no impacto para o usuário.
  • Reescreva os textos para garantir clareza, concisão e adequação ao público e situação.
  • Sempre que possível, teste o texto revisado com usuários reais.

Arquivos Sugeridos para Revisão

• Comece pelo SKILL.md para entender o processo da clarify.
• Explore arquivos de suporte para integração mais profunda e melhores práticas.

Perguntas Frequentes

Quando devo usar a skill clarify?

Use a clarify sempre que perceber que usuários estão confusos com textos da interface, mensagens de erro ou instruções, ou quando quiser melhorar proativamente a qualidade da escrita em UX.

A clarify altera código ou apenas texto?

A clarify foca em melhorar o texto da interface e microcopy. Ela não modifica a lógica de backend ou o código da aplicação.

Que preparação é necessária antes de usar a clarify?

É preciso reunir o contexto de design e entender seu público. Use /frontend-design e, se necessário, /teach-impeccable para garantir que você tenha todas as informações antes de editar os textos.

Onde encontro mais detalhes sobre o fluxo de trabalho da clarify?

Consulte o arquivo SKILL.md no diretório da skill clarify para um guia completo e passo a passo. Para recursos adicionais, revise a documentação e scripts relacionados no repositório.