zaDojo
Toute la documentation

Skill SEO Report : rapports HTML partageables

Comment les skills zaDojo livrent leur travail : un rapport HTML autonome enregistré dans votre projet, à lire, imprimer ou partager. Aucun crédit utilisé.

SEO Report est la skill que les autres skills zaDojo utilisent pour remettre leurs résultats. Quand votre agent termine un audit, une étude de mots-clés ou une analyse de concurrent, cette skill lui indique comment rédiger les conclusions sous forme d'une page HTML et l'enregistrer dans votre projet zaDojo. La page apparaît sur la page Reports du projet, où votre équipe peut la lire dans l'application, sur un téléphone ou sur papier.

L'idée est de sortir le travail terminé du fil de la conversation. Un rapport a un titre, une date, une mise en page fixe et une place dans le projet, pour que vous et le prochain agent le retrouviez le mois suivant.

Comment l'utiliser

La plupart du temps, vous ne l'appelez pas. Demandez le processus que vous voulez, et le rapport suit :

/zadojo:keyword-research Trouve des mots-clés pour notre page de tarifs.

Vous pouvez l'appeler directement pour une synthèse qu'aucune autre skill ne couvre, comme un court point sur le travail du mois, ou un rapport rédigé selon un de vos modèles enregistrés :

Utilise seo-report pour rédiger une synthèse d'une page des évolutions de positions de ce mois pour le client.

Ce que fait l'agent quand il enregistre un rapport

  1. Il appelle d'abord list_reports. Si un rapport sur le même sujet et la même période existe déjà, l'agent corrige son propre travail : il remplace ce rapport au lieu d'en ajouter une quasi-copie. Un nouveau mois, un nouveau concurrent ou une autre skill donnent un nouveau rapport.
  2. Il rédige des notes courtes. Le verdict et ce qu'il signifie pour l'activité viennent en premier. Chaque recommandation dit ce qui ne va pas (avec preuves), ce qu'il faut changer et ce que cela pourrait améliorer, avec le degré de certitude de l'agent. Les chiffres indiquent s'ils viennent d'un outil ou ont été vérifiés à la main.
  3. Il construit une seule page autonome. Tout le style est contenu dans le fichier. Pas de polices web, pas de scripts, pas d'images chargées depuis d'autres sites : la page s'affiche partout de la même façon et s'imprime proprement. Les graphiques sont en SVG intégré ou en barres simples, toujours avec les chiffres écrits à côté.
  4. La dernière section, « How this report was made », nomme la skill qui l'a produit, renvoie vers la page de cette skill dans cette documentation, et précise quels outils ont fourni quels chiffres et ce que l'agent a vérifié lui-même.
  5. En plus de la page, save_report stocke un court résumé que renvoie list_reports, pour qu'une session ultérieure puisse reprendre le travail sans ouvrir tout le HTML.
  6. La réponse dans la conversation reste brève : trois points au maximum (le verdict, la recommandation principale et ce sur quoi vous devez agir), suivis du lien.

Où trouver vos rapports

Ouvrez la page Reports depuis la barre latérale de votre projet. Le titre d'un rapport indique son type ou son sujet, plus la date complète de rédaction. Il n'inclut pas votre propre site, mais mentionne l'autre domaine quand le rapport porte sur le site de quelqu'un d'autre. Depuis un rapport, vous pouvez l'ouvrir en plein écran, dans un nouvel onglet, ou l'imprimer en PDF.

Un rapport enregistré n'a pas d'historique des versions. Quand l'agent corrige un rapport, la nouvelle version remplace l'ancienne.

Chaque rapport est d'abord privé à votre organisation. Pour en partager un, au choix :

  • demandez à votre agent : « rends ce rapport public et donne-moi le lien de partage », ou
  • ouvrez le rapport, cliquez sur Share et activez Public link.

Toute personne disposant du lien peut lire le rapport sans compte zaDojo. Le lien affiche toujours la dernière version enregistrée, et la page partagée demande aux moteurs de recherche de ne pas l'indexer. Désactivez l'option et le lien cesse de fonctionner (une page déjà ouverte peut encore se charger pendant une minute au plus). Réactiver le partage plus tard crée un nouveau lien.

L'agent ne publie un rapport que si vous le demandez explicitement. Demander un rapport « prêt pour le client » ne le rend pas public.

Modèles de rapport

Un modèle est un brief enregistré pour un type de rapport : qui le lit, quelles sections il contient et dans quel ordre, le ton et la signature. Vous gérez les modèles sur la page Templates, accessible depuis la page Reports. Les modèles appartiennent à un projet. Pour en réutiliser un ailleurs, demandez à votre agent de le lister dans le premier projet et d'en enregistrer une copie dans le second.

L'agent suit un modèle quand vous le nommez, ou quand vous demandez le type de rapport qu'il décrit, par exemple « rédige la mise à jour mensuelle client pour example.com ». Un simple « audite ce site » utilise toujours le format normal de la skill. Un modèle change les sections, le public et le ton. Il ne peut pas changer la construction de la page : un rapport issu d'un modèle s'imprime et fonctionne toujours sur téléphone. Les préférences de rédaction de votre projet s'appliquent par-dessus, et le modèle ne l'emporte qu'en cas de conflit.

Ce que ça coûte

Rien. Rédiger, enregistrer, lister et partager des rapports ne consomme aucun crédit. La recherche qui alimente un rapport est facturée par la skill qui la mène.

Conseils

  • Demandez la tâche, pas le format. « Audite example.com » produit un rapport sans que vous le demandiez.
  • Précisez à qui s'adresse le rapport. L'agent rédige la signature et adapte le langage à ce lecteur.
  • Si un rapport doit être corrigé, demandez à l'agent de le corriger. Il mettra à jour le même rapport au lieu d'en créer un second.
  • Les agents révisent un rapport à partir de son résumé enregistré, car le HTML complet d'un long rapport peut être trop volumineux pour qu'ils le relisent. Pour une grosse modification d'un ancien rapport, relancer la skill est souvent plus simple.

Lire la source

Le SKILL.md, avec le modèle HTML de départ sur lequel chaque rapport est construit :

Skills qui produisent leurs rapports avec elle