Reescrever os textos da pesquisa

Reescreve suas perguntas para que as pessoas terminem a pesquisa, partindo dos dados e não do gosto

Skill grátis para Claude Code, Codex, Cursor e Gemini CLI. Funciona pelo servidor MCP do SurveyNinja, com as suas permissões.

Categoria
Criar e divulgar
Tags
redação, funil
Funciona com
Claude Code, Codex, Cursor, Gemini CLI
Ferramentas MCP
6, 3 alteram dados
Versão
1.1, 20 de outubro de 2026
Feita por
SurveyNinja
Preço
Grátis
Arquivo da skill
SKILL.md

O que ela faz

  • Menos pesquisas abandonadas. As pessoas desistem quando deixam de entender para que serve a pergunta. Uma redação clara costuma ajudar mais do que cortar perguntas.
  • Corrige onde as pessoas desistem. Primeiro vêm as perguntas em que o pessoal desiste, não as que parecem estranhas.
  • O sentido continua o mesmo. A redação fica mais clara e as respostas continuam comparáveis com as que você já tem.

Exemplo

Você escreve

Reescreva as perguntas desta pesquisa em linguagem simples

O que o assistente traz

  1. Quão satisfeito você está com o serviço? antes: Favor avaliar o seu grau de satisfação com os serviços prestados
  2. Ficou pronto no prazo? / O preço foi justo? antes: Você ficou satisfeito com o prazo e o preço?
  3. Avalie o atendimento na recepção antes: Avalie o desempenho do front office
  4. Como foi o nosso atendimento? antes: Quanto você gostou do nosso excelente atendimento?
  5. Toda semana, todo mês ou com menos frequência antes: Com que frequência você nos visita? (texto livre)
A primeira tela é reescrita por inteiro

"Pesquisa de qualidade do atendimento" vira "Três perguntas sobre a sua visita. Suas respostas ajudam a diminuir a espera." O sentido é o mesmo e agora quem lê entende para que serve.

Os textos acima são um exemplo. Os ajustes são propostos para a sua pesquisa e o seu público.

Como funciona

  1. Vê onde as pessoas desistemAs perguntas em que o pessoal desiste são corrigidas primeiro, não as que só parecem estranhas. Se ainda não há respostas para analisar, o assistente avisa.
  2. Corrige os problemas de sempreTom formal demais, perguntas duplas, dupla negação, jargão interno, perguntas que induzem a resposta e perguntas sem opções definidas. Cada ajuste vem com antes e depois.
  3. Capricha na primeira telaÉ ali que a maioria desiste. Ela precisa dizer o que está sendo perguntado, quanto tempo leva e por que isso importa para quem lê. A última parte quase sempre falta.
  4. Só grava com a sua aprovaçãoPrimeiro você recebe a lista de ajustes, depois eles são aplicados. Muitas vezes os textos passam pela aprovação de um cliente ou do jurídico.

Experimente também

  • O pessoal desiste na pergunta três. Dá uma olhada na redação
  • Deixe a primeira tela da pesquisa mais convidativa

O que ela não faz

  • Não mudar o sentido de uma pergunta.
  • Não editar sem avisar os textos de uma pesquisa que já recebe respostas.
  • Não adicionar nem remover perguntas.
  • Não sugerir mudança de plano nem levar ao pagamento.

A skill funciona com as suas permissões. As ferramentas que alteram dados vêm marcadas, então você confere o que o assistente vai fazer antes de confirmar. Para cortar o acesso, remova o conector no assistente ou apague a chave de API.

Em resumo

Quais perguntas a skill corrige primeiro?

As que o pessoal abandona, pelas respostas não concluídas. Se ainda não houver respostas, ela corrige por regras gerais e avisa.

O que ela corrige na redação?

Tom formal demais, perguntas duplas, dupla negação, jargão interno, perguntas que induzem a resposta e perguntas sem opções definidas, como "com que frequência você nos visita?" em texto livre.

O que a primeira tela precisa dizer?

O que está sendo perguntado, quanto tempo leva e por que isso importa para quem lê. A última parte é a que mais falta, e é ela que decide.

Ela reescreve tudo de uma vez?

Não. Primeiro mostra o antes e depois de cada pergunta e só grava depois que você aprova, porque os textos muitas vezes passam por um cliente ou pelo jurídico.

Dá para editar uma pesquisa que já está recebendo respostas?

Só depois de um aviso: as respostas de antes e depois do ajuste deixam de ser comparáveis. O assistente avisa antes de mexer em qualquer coisa.

O que preciso para usar esta skill?

Uma conta no SurveyNinja em qualquer plano, inclusive o gratuito, e um assistente de IA compatível com MCP que carregue skills de uma pasta, como Claude Code, Codex, Cursor ou Gemini CLI. A skill é um arquivo de texto; o assistente trabalha com a sua chave de API ou com o acesso que você autoriza ao conectar.

A skill completa

O arquivo SKILL.md que o assistente lê, exatamente como está no arquivo para download.

Ver o texto completo

Rewriting so people finish

People rarely abandon a survey because it is long. They abandon it at the question where they stop seeing what is in it for them. Fixing the copy often helps more than cutting questions.

Reply to the person in the language they write in. Write the survey copy in the language of its audience.

Start from data, not taste

get_quiz_answers with is_complete set to false lists unfinished responses, up to 100 per page (page with offset): note the last question each one answered and find where most of them stop. The report does not show this: it holds completed responses only. Fix those questions first, not the ones that merely look wrong.

Incomplete responses are not saved on every plan, and then the same call quietly returns completed ones: check is_complete on each response. If there are no unfinished ones, say why: either there are no responses yet or the plan does not keep unfinished ones. Then edit by general rules and suggest looking at behavior once responses come in.

Question wording, the welcome and thank-you screens are widget fields: read them with get_quiz_structure, write them with update_quiz_widgets. Button labels and other interface strings come from get_quiz_texts and are saved by their code with update_quiz_texts.

What to fix

Problem How it looks Better
Formal, bureaucratic tone "Please rate your level of satisfaction with the services rendered" "How happy are you with the work?"
Double question "Were the price and the timing right?" two separate questions
Double negative "Do you disagree that we should not…" a direct question
Internal jargon "Rate the front office" "Rate the staff at the front desk"
Leading question "How much did you enjoy our excellent service?" "How was our service?"
Question without bounds "How often do you visit?" as open text options: weekly, monthly, less often

The first screen

This is where most people are lost. It needs three things: what is being asked, how long it takes, and why the person should care. The last one is usually missing, and it is the one that decides.

"Customer satisfaction survey" is weak. "Three questions about your visit. Your answers help us cut waiting times" works.

Buttons and thank-you

Default labels work, but a human label on the last step helps completion. The thank-you screen is the place to say what happens next ("We read every answer this week").

Order of work

  1. Show the proposed edits: before and after, question by question.
  2. Wait for agreement.
  3. Write.
  4. Widget edits land in the draft: respondents see them only after publish_quiz. Ask before publishing. Interface strings saved with update_quiz_texts reach the live survey at once.

Do not rewrite everything silently: copy is often agreed with a client or a legal team.

What not to do

  • Do not change the meaning of a question for the sake of nicer wording: comparability with earlier responses breaks.
  • Do not edit copy of a survey already collecting responses without warning: answers before and after the edit stop being comparable.
  • Do not add or remove questions. That is different work.
  • Do not suggest a plan upgrade or lead to payment. If a limit is hit, state the fact and stop.
O ninja do SurveyNinja em um foguete

Conecte o SurveyNinja ao seu assistente

O servidor MCP funciona em todos os planos, inclusive no Free. Crie sua conta, permita o acesso e peça ao assistente para montar a primeira pesquisa.