zaDojo
Toda a documentação

Skill SEO Report: relatórios HTML para compartilhar

Como as skills do zaDojo entregam o trabalho: um relatório HTML autônomo salvo no seu projeto, pronto para ler, imprimir ou compartilhar por link. Sem créditos.

SEO Report é a skill que as outras skills do zaDojo usam para entregar seus resultados. Quando seu agente termina uma auditoria, um estudo de palavras-chave ou uma análise de concorrente, esta skill diz como escrever as conclusões em uma página HTML e salvá-la no seu projeto do zaDojo. A página aparece na tela Reports do projeto, onde seu time pode ler no app, no celular ou no papel.

A ideia é tirar o trabalho pronto da rolagem do chat. Um relatório tem título, data, layout fixo e um lugar no projeto, então você e o próximo agente conseguem encontrá-lo no mês que vem.

Como usar

Na maioria das vezes você não chama esta skill. Peça o fluxo que você quer e o relatório vem junto:

/zadojo:keyword-research Encontre palavras-chave para a nossa página de preços.

Você pode chamá-la diretamente quando quer um texto que nenhuma outra skill cobre, como um resumo curto do trabalho feito no mês, ou um relatório escrito com um dos seus modelos salvos:

Use o seo-report para escrever um resumo de uma página das mudanças de posições deste mês para o cliente.

O que o agente faz ao salvar um relatório

  1. Ele chama list_reports primeiro. Se já existe um relatório sobre o mesmo assunto e período, o agente está corrigindo o próprio trabalho, então substitui esse relatório em vez de criar uma quase cópia. Um mês novo, um concorrente novo ou outra skill geram um relatório novo.
  2. Ele escreve notas curtas. O veredito e o que ele significa para o negócio vêm primeiro. Cada recomendação diz o que está errado (com evidências), o que mudar e o que isso pode melhorar, incluindo o grau de certeza do agente. Os números dizem se vieram de uma ferramenta ou foram conferidos à mão.
  3. Ele monta uma página autônoma. Todo o estilo fica dentro do arquivo. Não há fontes da web, scripts nem imagens carregadas de outros sites, então a página aparece igual em todo lugar e imprime direitinho. Os gráficos são SVG inline ou barras simples, sempre com os números escritos ao lado.
  4. A última seção, "Como este relatório foi feito", cita a skill que o produziu, linka para a página dessa skill nesta documentação e diz quais ferramentas informaram quais números e o que o próprio agente verificou.
  5. Junto com a página, save_report guarda um resumo curto que list_reports retorna, para uma sessão futura retomar o trabalho sem abrir o HTML completo.
  6. A resposta no chat é curta: no máximo três itens (o veredito, a principal recomendação e o que você precisa fazer) seguidos do link.

Onde encontrar seus relatórios

Abra a tela Reports pela barra lateral do projeto. Os títulos dizem o tipo de relatório ou o assunto, mais a data completa em que foi escrito. O título não inclui o seu próprio site e inclui o outro domínio quando o relatório é sobre o site de outra pessoa. Em um relatório, você pode abrir em tela cheia, abrir em uma aba própria ou imprimir em PDF.

Um relatório salvo não tem histórico de versões. Quando o agente corrige um relatório, a nova versão substitui a antiga.

Todo relatório começa privado para a sua organização. Para compartilhar, você pode:

  • pedir ao agente: "deixe este relatório público e me passe o link de compartilhamento", ou
  • abrir o relatório, clicar em Share e ativar Public link.

Qualquer pessoa com o link lê o relatório sem conta no zaDojo. O link sempre mostra a última versão salva, e a página compartilhada pede aos buscadores que não a indexem. Desative a opção e o link para de funcionar (uma página que alguém já está com aberta pode continuar carregando por até um minuto). Ativar o compartilhamento de novo depois cria um link novo.

O agente só publica um relatório quando você pede isso com todas as letras. Pedir um relatório "pronto para o cliente" não o torna público.

Modelos de relatório

Um modelo é um briefing salvo para um tipo de relatório: quem lê, quais seções tem e em que ordem, o tom e a assinatura. Você gerencia os modelos na tela Templates, que se acessa pela tela Reports. Os modelos pertencem a um projeto. Para reutilizar um em outro lugar, peça ao agente para listá-lo no primeiro projeto e salvar uma cópia no segundo.

O agente segue um modelo quando você o cita pelo nome, ou quando pede o tipo de relatório que ele descreve, por exemplo "escreva a atualização mensal do cliente para example.com". Um simples "audite este site" continua usando o formato normal da skill. Um modelo muda as seções, o público e o tom. Ele não muda como a página é construída, então um relatório com modelo continua imprimindo e funcionando no celular. As preferências de escrita do seu projeto se aplicam por cima, e o modelo só prevalece onde os dois entram em conflito.

Quanto custa

Nada. Escrever, salvar, listar e compartilhar relatórios não usa créditos. A pesquisa que entra em um relatório é cobrada pela skill que a faz.

Dicas

  • Peça a tarefa, não o formato. "Audite example.com" gera um relatório sem você pedir.
  • Diga para quem é o relatório. O agente escreve a assinatura e ajusta a linguagem para esse leitor.
  • Se um relatório precisa de ajuste, peça ao agente para corrigi-lo. Ele atualiza o mesmo relatório em vez de criar um segundo.
  • Os agentes revisam um relatório a partir do resumo salvo, porque o HTML completo de um relatório longo pode ser grande demais para eles lerem de volta. Para uma mudança grande em um relatório antigo, rodar a skill de novo costuma ser mais simples.

Leia o código-fonte

O SKILL.md, incluindo o modelo HTML inicial a partir do qual todo relatório é montado:

Skills que entregam relatórios por ela