zaDojo
Alle Docs

SEO-Report-Skill für teilbare HTML-Berichte

So liefern zaDojo-Skills ihre Arbeit ab: als eigenständiger HTML-Bericht im Projekt, bereit zum Lesen, Drucken oder Teilen per Link. Berichte kosten nichts.

SEO Report ist der Skill, mit dem die anderen zaDojo-Skills ihre Ergebnisse übergeben. Wenn dein Agent ein Audit, eine Keyword-Studie oder eine Wettbewerbsanalyse abgeschlossen hat, sagt ihm dieser Skill, wie er die Ergebnisse als eine HTML-Seite schreibt und in deinem zaDojo-Projekt speichert. Die Seite erscheint auf der Seite Reports des Projekts, wo dein Team sie in der App, auf dem Handy oder auf Papier lesen kann.

Es geht darum, fertige Arbeit aus dem Chatverlauf herauszuholen. Ein Bericht hat einen Titel, ein Datum, ein festes Layout und einen Platz im Projekt, damit du und der nächste Agent ihn auch nächsten Monat finden.

So nutzt du ihn

Meistens rufst du ihn gar nicht auf. Bitte um den Ablauf, den du willst, und der Bericht kommt mit:

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

Direkt aufrufen kannst du ihn, wenn du eine Zusammenfassung willst, die kein anderer Skill abdeckt, etwa einen kurzen Zwischenstand zur Arbeit dieses Monats oder einen Bericht nach einer deiner gespeicherten Vorlagen:

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

Was der Agent beim Speichern eines Berichts tut

  1. Er ruft zuerst list_reports auf. Gibt es schon einen Bericht zum selben Thema und Zeitraum, korrigiert der Agent seine eigene Arbeit und ersetzt diesen Bericht, statt eine fast identische Kopie anzulegen. Ein neuer Monat, ein neuer Wettbewerber oder ein anderer Skill bekommt einen neuen Bericht.
  2. Er schreibt knappe Notizen. Das Fazit und was es für das Geschäft bedeutet, kommen zuerst. Jede Empfehlung sagt, was falsch ist (mit Beleg), was zu ändern ist und was das verbessern könnte, samt der Angabe, wie sicher sich der Agent ist. Bei Zahlen steht, ob sie aus einem Tool stammen oder von Hand geprüft wurden.
  3. Er baut eine eigenständige Seite. Alle Styles stecken in der Datei. Es gibt keine Web-Fonts, keine Skripte und keine von anderen Websites geladenen Bilder, also sieht die Seite überall gleich aus und lässt sich sauber drucken. Diagramme sind Inline-SVG oder einfache Balken, immer mit den Zahlen daneben.
  4. Der letzte Abschnitt, "How this report was made", nennt den Skill, der den Bericht erstellt hat, verlinkt auf die Seite dieses Skills in dieser Dokumentation und sagt, welche Tools welche Zahlen geliefert haben und was der Agent selbst geprüft hat.
  5. Neben der Seite speichert save_report eine kurze Zusammenfassung, die list_reports zurückgibt, damit eine spätere Sitzung die Arbeit fortsetzen kann, ohne das ganze HTML zu öffnen.
  6. Die Antwort im Chat bleibt kurz: höchstens drei Stichpunkte (das Fazit, die wichtigste Empfehlung und alles, worum du dich kümmern musst), gefolgt vom Link.

Wo du deine Berichte findest

Öffne die Seite Reports über die Seitenleiste deines Projekts. Berichtstitel nennen die Art des Berichts oder sein Thema plus das vollständige Datum, an dem er geschrieben wurde. Deine eigene Website steht nicht im Titel, die andere Domain schon, wenn es im Bericht um eine fremde Website geht. Einen Bericht kannst du im Vollbild öffnen, in einem eigenen Tab öffnen oder als PDF drucken.

Ein gespeicherter Bericht hat keinen Versionsverlauf. Korrigiert der Agent einen Bericht, ersetzt die neue Version die alte.

Jeder Bericht ist anfangs nur für deine Organisation sichtbar. Um einen zu teilen, hast du zwei Möglichkeiten:

  • Bitte deinen Agenten: "make this report public and give me the share link", oder
  • öffne den Bericht, klick auf Share und schalte Public link ein.

Jeder mit dem Link kann den Bericht ohne zaDojo-Konto lesen. Der Link zeigt immer die zuletzt gespeicherte Version, und die geteilte Seite weist Suchmaschinen an, sie nicht zu indexieren. Schaltest du den Schalter aus, funktioniert der Link nicht mehr (eine bereits geöffnete Seite kann noch bis zu einer Minute laden). Schaltest du das Teilen später wieder ein, entsteht ein neuer Link.

Der Agent veröffentlicht einen Bericht nur, wenn du ausdrücklich darum bittest. Die Bitte um einen "kundenfertigen" Bericht macht ihn nicht öffentlich.

Berichtsvorlagen

Eine Vorlage ist ein gespeichertes Briefing für eine Art von Bericht: wer ihn liest, welche Abschnitte er in welcher Reihenfolge hat, der Ton und der Abschluss. Vorlagen verwaltest du auf der Seite Templates, die du über die Seite Reports erreichst. Vorlagen gehören zu einem Projekt. Willst du eine anderswo nutzen, bitte deinen Agenten, sie im ersten Projekt aufzurufen und eine Kopie im zweiten zu speichern.

Der Agent folgt einer Vorlage, wenn du sie beim Namen nennst oder um die Art von Bericht bittest, die sie beschreibt, zum Beispiel "write the monthly client update for example.com". Ein einfaches "audit this site" nutzt weiterhin das normale Format des Skills. Eine Vorlage ändert Abschnitte, Zielgruppe und Ton. Wie die Seite gebaut wird, ändert sie nicht, also lässt sich auch ein Bericht nach Vorlage drucken und funktioniert auf dem Handy. Die Schreibvorgaben deines Projekts gelten zusätzlich, und die Vorlage hat nur dort Vorrang, wo sich beide widersprechen.

Was es kostet

Nichts. Berichte zu schreiben, zu speichern, aufzulisten und zu teilen verbraucht kein Guthaben. Die Recherche für einen Bericht wird von dem Skill abgerechnet, der sie durchführt.

Tipps

  • Bitte um die Aufgabe, nicht um das Format. "Audit example.com" erzeugt einen Bericht, ohne dass du danach fragst.
  • Sag, für wen der Bericht ist. Der Agent schreibt die Autorenzeile und passt die Sprache an diese Leser an.
  • Muss ein Bericht korrigiert werden, bitte den Agenten darum. Er aktualisiert denselben Bericht, statt einen zweiten anzulegen.
  • Agenten überarbeiten einen Bericht anhand seiner gespeicherten Zusammenfassung, weil das vollständige HTML eines langen Berichts zu groß sein kann, um es zurückzulesen. Für eine große Änderung an einem alten Bericht ist es oft einfacher, den Skill neu auszuführen.

Quelltext lesen

Die SKILL.md, einschließlich der HTML-Startvorlage, auf der jeder Bericht aufbaut:

Skills, die darüber berichten