🎤 Faça a Skill Perguntar

O loop morto é o padrão mais frustrante no uso de skills de geração de conteúdo. Funciona assim: você aciona a skill, recebe um output genérico, pede refinamento, recebe outro output ligeiramente diferente mas ainda genérico, pede mais refinamento, e assim por diante — sem nunca chegar no resultado que você realmente quer. O problema não é a qualidade da skill em si — é que ela não tem o contexto necessário para gerar algo realmente específico. Sem saber para quem, em qual plataforma e com qual objetivo, a skill só pode produzir o denominador comum de todos os casos possíveis: o genérico.

O loop morto: iterações sem fim sem nunca chegar ao output correto

O Ask User Input Tool é uma primitiva nativa do Claude Code que permite que a skill pause sua execução e faça uma pergunta direta ao usuário, aguardando a resposta antes de continuar. É o mecanismo que transforma a skill de um gerador de output em um sistema de entrevista + geração. Ao contrário de incluir perguntas no corpo do output (o que muitas pessoas fazem de forma gambiarra), o Ask User Input Tool é a forma técnica correta — ela pausa o fluxo e coleta a informação antes de qualquer geração acontecer.

Nem toda skill se beneficia de entrevista. Adicionar perguntas em skills onde o contexto já é suficiente cria fricção desnecessária que desgasta o usuário. O critério principal é: a saída da skill varia significativamente dependendo do contexto do usuário? Se sim, entreviste. Se a skill gera output relativamente consistente independente de quem a usa, a entrevista vai apenas atrasar o processo sem agregar qualidade.

A armadilha comum é fazer muitas perguntas achando que mais contexto sempre é melhor. Não é. Perguntas demais criam atrito e reduzem a probabilidade de o usuário completar a entrevista. O segredo é identificar as 2-4 perguntas que têm o maior impacto na qualidade do output e fazer apenas essas. Perguntas sobre contexto e objetivo têm impacto muito maior do que perguntas sobre preferências estéticas secundárias.

A entrevista pode ser estruturada de duas formas: linear (perguntas fixas em sequência independente das respostas) ou adaptativa (pergunta seguinte depende da resposta anterior). Para a maioria das skills, a entrevista linear é mais simples de implementar e suficientemente eficaz. A entrevista adaptativa só justifica a complexidade adicional quando o domínio tem variações radicalmente diferentes que requerem conjuntos completamente distintos de informação.

O exemplo abaixo mostra uma skill de copywriting para redes sociais completamente implementada com Ask User Input. Esta é a estrutura real que você pode usar como base e adaptar para seus próprios casos de uso. Observe a posição da entrevista: antes de qualquer instrução de geração, garantindo que o Claude colete tudo que precisa antes de começar a criar.