clarify

Visão Geral

O que é a skill clarify?

A skill clarify foi criada para ajudar designers de UI e UX, desenvolvedores frontend e equipes de produto a melhorar sistematicamente textos pouco claros na interface. Ela foca em refinar textos UX, mensagens de erro, microtextos, rótulos e instruções para tornar produtos digitais mais fáceis de entender e usar. Se seus usuários têm dificuldades com rótulos confusos, mensagens de erro vagas ou instruções difíceis de seguir, o clarify oferece uma abordagem estruturada para identificar e resolver esses problemas.

Quem deve usar o clarify?

O clarify é ideal para quem é responsável pelo design da interface, redação UX ou desenvolvimento frontend. É especialmente útil quando você recebe feedback sobre textos confusos, rótulos pouco claros ou mensagens de erro ineficazes, ou quando deseja melhorar proativamente a clareza da comunicação do seu produto.

Problemas que o clarify resolve

• Textos da interface pouco claros ou ambíguos
• Jargões técnicos que confundem os usuários
• Mensagens de erro que não ajudam o usuário a se recuperar
• Instruções difíceis de seguir
• Desalinhamento de tom ou falta de contexto no texto da interface

Como Usar

Passos para Instalação

1. Instale o clarify usando o comando abaixo:

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

2. Comece revisando o arquivo SKILL.md no diretório da skill clarify. Este arquivo detalha o fluxo de trabalho, passos de preparação e melhores práticas para aprimorar textos da interface.

Visão Geral do Fluxo de Trabalho

• Preparação Obrigatória:

  • Execute $frontend-design para acessar princípios de design e o Protocolo de Coleta de Contexto.
  • Se não houver contexto de design disponível, execute $teach-impeccable primeiro.
  • Reúna informações sobre o nível técnico do seu público e o estado mental dos usuários.

• Avalie o Texto Atual:

  • Identifique problemas de clareza como jargões, ambiguidade, voz passiva, extensão, suposições, falta de contexto e desalinhamento de tom.
  • Entenda o contexto: público, estado do usuário, ação pretendida e restrições.

• Planeje e Melhore:

  • Aborde sistematicamente cada problema de clareza.
  • Reescreva os textos considerando a perspectiva e o estado mental do usuário.
  • Teste os textos revisados com usuários reais ou partes interessadas.

Estrutura de Arquivos e Recursos Principais

• Comece pelo SKILL.md para o fluxo principal.
• Contexto adicional pode estar em README.md, AGENTS.md e pastas de suporte como rules/, resources/ ou references/, se disponíveis na sua instalação.

Perguntas Frequentes

Quando devo usar o clarify?

Use o clarify sempre que encontrar textos confusos, ambíguos ou ineficazes na interface, ou quando quiser melhorar proativamente a clareza e usabilidade da comunicação do seu produto.

Que tipos de texto o clarify ajuda a melhorar?

O clarify é eficaz para textos UX, mensagens de erro, microtextos, rótulos e instruções — qualquer texto da interface que impacte o entendimento do usuário.

Preciso de contexto de design antes de usar o clarify?

Sim. O fluxo do clarify exige que você reúna contexto de design e compreenda seu público antes de fazer alterações. Se não tiver esse contexto, siga os passos de preparação descritos no SKILL.md.

Onde posso encontrar mais detalhes?

Abra a aba Arquivos no diretório das suas skills para explorar a árvore completa de arquivos, incluindo SKILL.md e quaisquer scripts ou referências de suporte.