zaDojo
Toda la documentación

Skill SEO Report: informes HTML para compartir

Cómo entregan su trabajo las skills de zaDojo: un informe HTML autónomo guardado en tu proyecto, listo para leer, imprimir o compartir. Sin gastar créditos.

SEO Report es la skill que usan las demás skills de zaDojo para entregar sus resultados. Cuando tu agente termina una auditoría, un estudio de palabras clave o un análisis de la competencia, esta skill le indica cómo redactar las conclusiones como una página HTML y guardarla en tu proyecto de zaDojo. La página aparece en la sección Reports del proyecto, donde tu equipo puede leerla en la app, en el móvil o en papel.

La idea es sacar el trabajo terminado del historial del chat. Un informe tiene un título, una fecha, un diseño fijo y un sitio en el proyecto, así que tú y el siguiente agente podréis encontrarlo el mes que viene.

Cómo se usa

Casi nunca la llamas tú. Pide el flujo de trabajo que quieres y el informe viene incluido:

/zadojo:keyword-research Find keywords for our pricing page.

Puedes llamarla directamente cuando quieras un documento que no cubre ninguna otra skill, como un breve repaso del trabajo hecho este mes, o un informe que siga una de tus plantillas guardadas:

Use seo-report to write a one-page summary of this month's ranking changes for the client.

Qué hace el agente al guardar un informe

  1. Primero llama a list_reports. Si ya existe un informe sobre el mismo tema y periodo, el agente está corrigiendo su propio trabajo, así que sustituye ese informe en lugar de añadir una copia casi igual. Un mes nuevo, un competidor nuevo o una skill distinta generan un informe nuevo.
  2. Escribe notas breves. Primero va el veredicto y lo que significa para el negocio. Cada recomendación dice qué falla (con pruebas), qué cambiar y qué podría mejorar, incluido el grado de seguridad del agente. Las cifras indican si vienen de una herramienta o se comprobaron a mano.
  3. Construye una página autónoma. Todos los estilos van dentro del archivo. No hay fuentes web, ni scripts, ni imágenes cargadas de otros sitios, así que la página se ve igual en todas partes y se imprime bien. Los gráficos son SVG en línea o barras sencillas, siempre con las cifras escritas al lado.
  4. La última sección, "How this report was made", nombra la skill que lo generó, enlaza a la página de esa skill en esta documentación y explica qué herramientas dieron qué cifras y qué comprobó el propio agente.
  5. Junto con la página, save_report guarda un breve resumen que devuelve list_reports, para que una sesión posterior pueda retomar el trabajo sin abrir el HTML completo.
  6. La respuesta en el chat es corta: como mucho tres puntos (el veredicto, la recomendación principal y lo que tengas que hacer tú) seguidos del enlace.

Dónde encontrar tus informes

Abre la sección Reports desde la barra lateral de tu proyecto. Los títulos de los informes indican el tipo de informe o su tema, más la fecha completa en que se escribió. Un título no incluye tu propio sitio web, pero sí el otro dominio cuando el informe trata sobre el sitio de otra persona. Desde un informe puedes abrirlo a pantalla completa, abrirlo en su propia pestaña o imprimirlo en PDF.

Un informe guardado no tiene historial de versiones. Cuando el agente corrige un informe, la nueva versión sustituye a la anterior.

Todos los informes empiezan siendo privados para tu organización. Para compartir uno, puedes:

  • pedírselo a tu agente: "make this report public and give me the share link", o
  • abrir el informe, hacer clic en Share y activar Public link.

Cualquiera con el enlace puede leer el informe sin una cuenta de zaDojo. El enlace siempre muestra la última versión guardada, y la página compartida pide a los buscadores que no la indexen. Si desactivas el interruptor, el enlace deja de funcionar (una página que alguien ya tenga abierta puede seguir cargando hasta un minuto). Si vuelves a activar el uso compartido más adelante, se crea un enlace nuevo.

El agente solo publica un informe cuando se lo pides de forma explícita. Pedir un informe "listo para el cliente" no lo hace público.

Plantillas de informe

Una plantilla es un encargo guardado para un tipo de informe: quién lo lee, qué secciones tiene y en qué orden, el tono y la firma. Las plantillas se gestionan en la sección Templates, a la que llegas desde Reports. Cada plantilla pertenece a un proyecto. Para reutilizar una en otro, pide a tu agente que la liste en el primer proyecto y guarde una copia en el segundo.

El agente sigue una plantilla cuando la nombras, o cuando pides el tipo de informe que describe, por ejemplo "write the monthly client update for example.com". Un simple "audita este sitio" sigue usando el formato normal de la skill. Una plantilla cambia las secciones, el público y el tono. No puede cambiar cómo se construye la página, así que un informe con plantilla se sigue imprimiendo bien y funcionando en el móvil. Encima se aplican las preferencias de redacción de tu proyecto, y la plantilla solo manda donde las dos chocan.

Cuánto cuesta

Nada. Escribir, guardar, listar y compartir informes no gasta créditos. La investigación que alimenta un informe la cobra la skill que la hace.

Consejos

  • Pide la tarea, no el formato. "Audita example.com" genera un informe sin que lo pidas.
  • Di para quién es el informe. El agente escribe la firma y adapta el lenguaje a ese lector.
  • Si hay que corregir un informe, pide al agente que lo corrija. Actualizará el mismo informe en lugar de crear otro.
  • Los agentes revisan un informe a partir de su resumen guardado, porque el HTML completo de un informe largo puede ser demasiado grande para que lo vuelvan a leer. Para un cambio grande en un informe antiguo, suele ser más sencillo volver a ejecutar la skill.

Lee el código fuente

El SKILL.md, con la plantilla HTML de partida sobre la que se construye cada informe:

Skills que entregan sus informes con ella