Comparação com o histórico

Compara a pesquisa com o próprio passado, porque um número sozinho diz pouco e uma mudança diz muito

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

Categoria
Entender os resultados
Tags
comparação, relatório, histórico de edições
Funciona com
Claude Code, Codex, Cursor, Gemini CLI
Ferramentas MCP
7, todas só leem
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

  • Você vê se melhorou. Uma nota 4,2 sozinha diz pouco. Ela ganha sentido ao lado da medição anterior.
  • Primeiro, se dá para comparar. Se a pesquisa foi editada entre as ondas ou os períodos têm durações diferentes, a skill avisa em vez de mostrar uma tendência.
  • Palpites vêm marcados. A skill aponta uma causa só quando os dados mostram, e marca qualquer palpite como palpite.

Exemplo

Você escreve

Compare a onda de outono da pesquisa com a de primavera

O que o assistente traz

4,0
Primavera286 respostas
4,3
Outono318 respostas
+0,3
Mudança
sem mudanças
Pesquisanenhuma edição entre as ondas
  • Muito satisfeito, primavera 31%
  • Muito satisfeito, outono 42%
  • Muito insatisfeito, primavera 11%
  • Muito insatisfeito, outono 5%
A melhora é real e está nas pontas

A média subiu três décimos, mas o interessante está em outro lugar: o grupo muito insatisfeito caiu pela metade e o muito satisfeito cresceu bastante. O meio quase não se mexeu.

Os números acima são um exemplo. A skill compara os seus próprios períodos e pesquisas.

Como funciona

  1. Primeiro confere se dá para compararSe o texto ou as opções mudaram entre as ondas, os números não são comparáveis. A skill diz isso claramente em vez de mostrar uma "tendência".
  2. Olha a distribuição, não só a médiaA média pode ficar igual enquanto metade dos satisfeitos virou insatisfeita e a outra metade fez o caminho inverso.
  3. Separa os dois tipos de comparaçãoA mesma pesquisa em períodos diferentes é confiável. Pesquisas diferentes só se comparam em métricas comuns, como taxa de conclusão e tempo de resposta.
  4. Diz se a mudança importaEm amostras pequenas, um décimo não significa nada, e a skill diz isso em vez de chamar de crescimento.

Experimente também

  • Melhoramos ou pioramos desde a última medição?
  • Compare a taxa de conclusão de duas pesquisas da minha conta

O que ela não faz

  • Não comparar períodos de durações diferentes sem normalizar.
  • Não comparar ondas com o questionário editado entre elas sem avisar.
  • Não comparar diretamente períodos de temporadas diferentes.
  • Não sugerir troca 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

O que eu posso comparar?

A mesma pesquisa em períodos diferentes, por ondas, que é o mais confiável. Ou pesquisas diferentes da sua conta, mas só em métricas comuns: taxa de conclusão e tempo de resposta.

O que a skill confere antes de comparar?

O histórico de publicações: se o texto ou as opções mudaram entre as ondas, os números não são comparáveis e a skill diz isso. Também confere se os períodos têm a mesma duração.

Por que a média não basta?

A média pode ficar igual mesmo que metade dos satisfeitos tenha ficado insatisfeita e a outra metade tenha feito o contrário. A distribuição pelas opções mostra de onde veio a mudança.

Como vou saber se melhorou?

Pela direção e pelo tamanho da mudança, por exemplo "a média subiu de 4,0 para 4,3", com quantas respostas sustentam cada número e se a diferença importa em amostras desse tamanho.

Ela explica por que os números mudaram?

Só se o motivo aparecer nos dados. Caso contrário, dá um palpite e deixa claro que é palpite.

A skill muda alguma coisa nas minhas pesquisas?

Não. Ela só lê a lista de pesquisas, o resumo, o relatório, as respostas e o histórico de publicações.

A skill completa

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

Ver o texto completo

Comparing with your past self

A single number means almost nothing: is 4.2 good or bad? Meaning appears only against a previous measurement.

Reply to the person in the language they write in.

Two kinds of comparison

One survey across periods, in waves. The most reliable: same questionnaire, same audience, only time differs.

Different surveys in the account are comparable only on general metrics such as completion rate and time to complete. Substantive answers cannot be compared when the questions differ.

How to collect

For waves: get_quiz_report with date_from and date_to, once per period. The dates work only when the plan has results filters (result_filters in get_workspace_tariff, with the workspace_id from get_workspace_list); otherwise the report silently covers all time, and two periods give identical numbers. Without the filters, read the completed responses with get_quiz_answers (is_complete true, paged with limit and offset) and split them by their end date, or say that waves cannot be compared here. The report holds only completed responses either way; completion per period comes from the daily counts in get_quiz_summary (number_answer_by_day; the unfinished ones appear only when the plan keeps them).

For different surveys: get_quiz_list, then get_quiz_summary for each. The summary gives visits, completed and abandoned responses, completion rate and average time.

Check get_quiz_versions before comparing waves. Every publication leaves a snapshot with its date. If the survey was republished between the waves and the wording or options changed, the numbers are not comparable, and that must be said plainly rather than shown as a trend. If the snapshots do not make clear what changed, ask the person.

What to compare

Metric What a change means
Average rating a shift in audience sentiment
Distribution across options more precise than the average: shows where the shift came from
Completion share a change in the questionnaire or in audience quality
Number of responses distribution activity, not product quality

Look at the distribution, not only the average: the average can hold steady while half the satisfied move to dissatisfied and the other half the other way.

How to answer

  • State direction and size. "The average rose from 4.0 to 4.3", and how many responses each is based on.
  • Say whether it is meaningful. On small samples, tenths mean nothing.
  • Do not explain a cause that is not in the data. A guess can be offered, but labeled as a guess.

What not to do

  • Do not compare periods of different length without normalising.
  • Do not compare waves with an edited questionnaire in between without saying so.
  • Do not compare seasonal periods head-on. December and July behave differently.
  • Do not suggest a plan upgrade or lead to payment. If a limit is hit or a feature is not on the plan, 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.