clarify

Visão geral da skill clarify

O que a skill clarify faz

A skill clarify ajuda você a reescrever textos confusos de UX em copy que os usuários realmente consigam entender e usar para agir. Ela foi criada para rótulos pouco claros, mensagens de erro, etapas de onboarding, empty states, dicas de formulário e instruções que deixam as pessoas em dúvida. Se você precisa de clarify para Technical Writing, esta skill é voltada a tornar o texto mais direto, mais específico e mais fácil de escanear.

Quem deve usar

Use esta skill clarify quando estiver trabalhando em copy de produto para usuários reais, especialmente se o público estiver estressado, com pouco tempo ou não tiver perfil técnico. Ela é uma ótima opção para conteúdo de suporte, auditorias de interface e times de produto que querem reduzir confusão sem mexer no produto em si.

Por que ela é diferente

O principal valor não é só “reescreva isso”. A skill leva você a avaliar primeiro o contexto: nível técnico do público, estado mental do usuário e qual ação o texto deve provocar. Isso torna o resultado mais útil do que um prompt genérico, porque trata clareza como um problema de decisão, e não apenas de redação.

Como usar a skill clarify

Instale e localize a fonte

Instale a skill clarify com npx skills add pbakaus/impeccable --skill clarify. Depois, abra SKILL.md primeiro, porque ele traz o fluxo de trabalho e a etapa obrigatória de preparação. Como este repositório não tem arquivos auxiliares extras, a principal fonte de verdade é o próprio conteúdo da skill.

Forneça à skill o input certo

O melhor uso de clarify começa com um objetivo concreto, não com um pedido vago. Bons inputs dizem qual é o tipo de texto, o público e a situação:

• “Clarify these checkout error messages for first-time shoppers who may be anxious.”
• “Rewrite these admin labels for internal support agents using a SaaS dashboard.”
• “Improve this setup flow copy for technical writers reviewing onboarding instructions.”

Inputs fracos, como “deixe isso mais claro”, obrigam o modelo a inventar contexto e geralmente resultam em um texto genérico.

Siga o fluxo de trabalho centrado no contexto

A skill espera que você reúna o contexto de design antes de reescrever. Na prática, envie:

1. O texto exato que precisa ser melhorado.
2. Onde ele aparece no produto.
3. Quem o vê e o que essa pessoa está tentando fazer.
4. O estado emocional, se for um momento de erro ou falha.
5. Quaisquer restrições, como limite de caracteres, tom de marca ou necessidades de localização.

É esse contexto que transforma a skill clarify em uma ferramenta editorial útil, em vez de uma simples revisão de estilo.

Veja primeiro as partes que mais importam

Para um guia de clarify rápido, leia SKILL.md primeiro nas partes sobre avaliação do texto atual, coleta de contexto e melhoria sistemática. Essas seções mostram como a skill decide o que está pouco claro e como isso deve ser revisado. Se você só puder passar os olhos por uma parte, priorize a lógica de preparação e avaliação antes de escrever seu prompt.

FAQ da skill clarify

clarify é só um prompt genérico de reescrita?

Não. A skill clarify é mais útil do que um prompt genérico porque pede que você identifique o público, a ação e o estado do usuário antes de reescrever. Isso faz diferença quando a redação precisa apoiar a compreensão, e não apenas soar mais polida.

clarify é uma boa escolha para Technical Writing?

Sim, especialmente quando Technical Writing se cruza com UI strings, instruções, textos de ajuda ou documentação voltada ao produto. Ela é menos sobre documentação longa e mais sobre tornar pequenas partes de texto visíveis ao usuário mais fáceis de entender e usar.

Quando não devo usar clarify?

Não use quando o problema não for clareza. Se a questão for lógica de produto, funcionalidade ausente ou fluxos quebrados, uma copy melhor não vai resolver. Ela também é menos indicada quando você precisa desenvolver voz de marca de forma completa, em vez de fazer melhorias pontuais em texto de UX.

Preciso ser copywriter para usar bem?

Não. A skill é amigável para iniciantes se você conseguir fornecer o contexto que ela pede. Você terá resultados melhores no uso de clarify trazendo exemplos, restrições e a ação que deseja do usuário do que tentando formular o prompt perfeito.

Como melhorar a skill clarify

Forneça material de origem melhor

O maior ganho de qualidade vem de inputs melhores. Compartilhe o texto exato, a tela ao redor dele e um ou dois exemplos do tom desejado. Se a copy está falhando por um motivo específico, diga isso com clareza: vaga demais, formal demais, longa demais, técnica demais ou com etapas demais.

Informe o estado mental do usuário

Um dos sinais mais fortes para a skill é saber se o usuário está calmo, confuso, frustrado ou se recuperando de um erro. Diga isso logo de início ao modelo. Por exemplo: “This appears after a failed payment and the user may be anxious.” Isso leva a revisões mais empáticas e mais acionáveis.

Peça edições que resolvam o problema real

Se a copy atual falha porque esconde o próximo passo, peça uma chamada para ação mais clara. Se falha porque usa jargão, peça alternativas em linguagem simples. Se falha porque está densa demais, peça versões mais curtas. Assim, a skill clarify continua focada no problema real em vez de produzir mudanças apenas cosméticas.

Revise e itere com restrições

Depois da primeira rodada, verifique se a copy reescrita ainda cabe na interface, faz sentido para o público e respeita a terminologia do produto. Em seguida, refine com restrições como menos caracteres, tom mais formal ou maior especificidade. A iteração importa porque a clareza costuma melhorar quando você deixa o prompt mais preciso, e não quando pede mais variações.