zaDojo
Alle documentatie

SEO Report-skill voor deelbare HTML-rapporten

Hoe zaDojo-skills hun werk opleveren: één zelfstandig HTML-rapport in je project, klaar om te lezen, te printen of via een link te delen. Rapporten zijn gratis.

SEO Report is de skill waarmee de andere zaDojo-skills hun resultaten overdragen. Rondt je agent een audit, zoekwoordonderzoek of concurrentieanalyse af, dan vertelt deze skill hem hoe hij de bevindingen als één HTML-pagina schrijft en in je zaDojo-project opslaat. De pagina verschijnt op de Reports-pagina van het project, waar je team hem kan lezen in de app, op een telefoon of op papier.

Het doel is afgerond werk uit de chatgeschiedenis te halen. Een rapport heeft een titel, een datum, een vaste opmaak en een vaste plek in het project, zodat jij en de volgende agent het volgende maand terugvinden.

Hoe je hem gebruikt

Meestal roep je hem niet zelf aan. Vraag om de workflow die je wilt, en het rapport komt er vanzelf bij:

/zadojo:keyword-research Vind zoekwoorden voor onze prijspagina.

Je kunt hem direct aanroepen als je een verslag wilt dat geen andere skill dekt, zoals een korte stand van zaken over het werk van deze maand, of een rapport volgens een van je opgeslagen templates:

Gebruik seo-report om voor de klant een samenvatting van één pagina te schrijven over de veranderingen in posities deze maand.

Wat de agent doet als hij een rapport opslaat

  1. Hij roept eerst list_reports aan. Bestaat er al een rapport over hetzelfde onderwerp en dezelfde periode, dan corrigeert de agent zijn eigen werk en vervangt hij dat rapport in plaats van een bijna-kopie toe te voegen. Een nieuwe maand, een nieuwe concurrent of een andere skill krijgt een nieuw rapport.
  2. Hij schrijft korte aantekeningen. Het oordeel en wat het voor het bedrijf betekent, komen eerst. Elke aanbeveling zegt wat er mis is (met bewijs), wat je verandert en wat dat kan verbeteren, inclusief hoe zeker de agent is. Bij cijfers staat of ze uit een tool komen of met de hand zijn gecontroleerd.
  3. Hij bouwt één zelfstandige pagina. Alle opmaak zit in het bestand. Er zijn geen webfonts, geen scripts en geen afbeeldingen van andere sites, dus de pagina ziet er overal hetzelfde uit en print netjes. Grafieken zijn inline SVG of eenvoudige balken, altijd met de cijfers ernaast.
  4. Het laatste deel, "Hoe dit rapport is gemaakt", noemt de skill die het maakte, linkt naar de pagina van die skill in deze documentatie en vermeldt welke tools welke cijfers leverden en wat de agent zelf heeft gecontroleerd.
  5. Naast de pagina slaat save_report een korte samenvatting op die list_reports teruggeeft, zodat een latere sessie het werk kan oppakken zonder de volledige HTML te openen.
  6. Het antwoord in de chat blijft kort: hooguit drie punten (het oordeel, de belangrijkste aanbeveling en alles waarop jij moet handelen), gevolgd door de link.

Waar je je rapporten vindt

Open de Reports-pagina via de zijbalk van je project. Rapporttitels noemen het type rapport of het onderwerp, plus de volledige datum waarop het is geschreven. Een titel laat je eigen website weg en noemt het andere domein als het rapport over de site van iemand anders gaat. Vanuit een rapport kun je het schermvullend openen, in een eigen tabblad openen of als pdf printen.

Een opgeslagen rapport heeft geen versiegeschiedenis. Corrigeert de agent een rapport, dan vervangt de nieuwe versie de oude.

Elk rapport is in het begin privé voor je organisatie. Om er een te delen, doe je een van deze twee:

  • vraag je agent: "maak dit rapport openbaar en geef me de deellink", of
  • open het rapport, klik op Share en zet Public link aan.

Iedereen met de link kan het rapport lezen zonder zaDojo-account. De link toont altijd de laatst opgeslagen versie, en de gedeelde pagina vertelt zoekmachines dat ze hem niet moeten indexeren. Zet je de schakelaar uit, dan werkt de link niet meer (een pagina die iemand al open heeft, kan nog tot een minuut blijven laden). Zet je delen later weer aan, dan krijg je een nieuwe link.

De agent publiceert een rapport alleen als je daar uitdrukkelijk om vraagt. Vragen om een rapport "dat klaar is voor de klant" maakt het niet openbaar.

Rapporttemplates

Een template is een opgeslagen briefing voor een soort rapport: wie het leest, welke onderdelen het heeft en in welke volgorde, de toon en de afsluiting. Je beheert templates op de Templates-pagina, die je via de Reports-pagina bereikt. Templates horen bij één project. Wil je er een elders gebruiken, vraag je agent dan om hem in het eerste project op te zoeken en een kopie in het tweede op te slaan.

De agent volgt een template als je hem noemt, of als je vraagt om het soort rapport dat hij beschrijft, bijvoorbeeld "schrijf de maandelijkse klantupdate voor example.com". Een gewoon "audit deze site" gebruikt nog steeds de normale opmaak van de skill. Een template verandert de onderdelen, het publiek en de toon. Het kan niet veranderen hoe de pagina is opgebouwd, dus een rapport volgens een template print nog steeds goed en werkt nog steeds op een telefoon. De schrijfvoorkeuren van je project gelden daarbovenop, en de template wint alleen waar die twee botsen.

Wat het kost

Niets. Rapporten schrijven, opslaan, opvragen en delen kost geen tegoed. Het onderzoek dat in een rapport gaat, wordt afgerekend door de skill die het uitvoert.

Tips

  • Vraag om de klus, niet om de vorm. "Audit example.com" levert een rapport op zonder dat je erom vraagt.
  • Zeg voor wie het rapport is. De agent schrijft de naamregel en stemt de taal af op die lezer.
  • Moet een rapport worden aangepast, vraag de agent het dan te corrigeren. Hij werkt hetzelfde rapport bij in plaats van een tweede te maken.
  • Agents herzien een rapport op basis van de opgeslagen samenvatting, omdat de volledige HTML van een lang rapport te groot kan zijn om terug te lezen. Voor een grote wijziging in een oud rapport is de skill opnieuw draaien vaak eenvoudiger.

De bron lezen

De SKILL.md, inclusief het HTML-starttemplate waarop elk rapport is gebouwd:

Skills die via deze skill rapporteren