Documentatie

AI-agents (MCP)

Playbook-skills

De 22 playbooks die de AmICited MCP-server meelevert als skill-resources: welke tools je in welke volgorde aanroept en de valkuilen waardoor een zelfverzekerd antwoord fout is.

Tools zijn wat een agent kan bereiken. Skills zijn hoe je ze voor een echte vraag gebruikt. Bij meer dan 300 tools is het vinden van één zelden het moeilijke deel: het gaat erom te weten dat “waarom daalde het verkeer” zes rapporten in een bepaalde volgorde nodig heeft, of dat een leeg ecommercerapport “niet gekoppeld” kan betekenen in plaats van “nul omzet”.

De AmICited MCP-server levert deze playbooks mee als MCP-resources. Elk is geschreven door agents moeilijke vragen te laten beantwoorden op de live server zonder playbook, elke doodlopende weg en verkeerde aanname vast te leggen en die mislukkingen om te zetten in instructies. Elke toolnaam die een skill noemt, wordt bij elke build gecontroleerd tegen het live toolregister, dus een skill wijst nooit naar een tool die niet meer bestaat.

Hoe agents ze vinden#

Skills worden geserveerd op skill://<name>/SKILL.md. Ze opsommen kost een naam en één regel per skill; de inhoud wordt pas opgehaald wanneer een agent die wil.

  • De instructies van de server, die bij het koppelen naar elke client worden gestuurd, zeggen de agent eerst skill://using-amicited/SKILL.md te lezen. Die skill legt de lus vinden, inspecteren, uitvoeren uit en somt de andere op.
  • Veel clients lijsten zelf nooit resources op. Als je agent een skill lijkt niet te kennen, noem hem dan: “Read skill://ai-visibility-audit/SKILL.md, then audit example.com.”
  • Skills zijn alleen-lezentekst. Een skill lezen telt niet mee voor het uurlijkse limiet van toolaanroepen.

Conventies#

SkillDoel
using-amicitedHoe je het endpoint bedient: de juiste tool vinden uit 300+, hem aanroepen en de conventies die elke andere skill aanneemt. Lees eerst.
report-windowsDatumvensters en vergelijkingsperiodes over rapporten heen: de verschillende argumentstijlen, de regel van gelijke lengte en hoe je zelfverzekerd foute cijfers vermijdt.

AI-zichtbaarheid en concurrenten#

SkillDoel
ai-visibility-auditDiagnosticeer waarom een merk wel of niet wordt aangehaald in AI-antwoorden: welke engines echt liepen, wat het kopgetal verbergt en vier controles die een kloof verklaren.
competitor-gap-analysisVind waar concurrenten AI-antwoorden en zoekresultaten winnen die jij niet wint, en welke kloven je eerst aanpakt.
competitor-content-gapsVind secties in sitemaps van concurrenten, vocabulaire en publicatiekloven zonder onvolledige actualiteitsdata te overdrijven.
ai-fanout-queriesVind de zoekopdrachten die een AI-assistent tegen je site uitvoerde (die met een site:-operator) en lees ze zonder nul doorkliks voor een probleem aan te zien.
prompt-set-designVoeg gevolgde prompts toe voor een domein: hoe een goede promptset eruitziet, de valkuil bij tags en waarom hier niets de creditkosten kan vertellen.

Organische zoekdiagnostiek#

SkillDoel
traffic-drop-triageBepaal waarom organisch verkeer verschoof: lokaliseer het tot een zoekopdracht of pagina, dateer de stap en sluit indexering, storingen en sitewijzigingen uit voordat je rankings de schuld geeft.
did-our-change-workKoppel een sitewijziging aan wat erna gebeurde, en waarom een lege annotatiehistorie geen bewijs van iets is.
indexing-triageOnderzoek indexeringsproblemen: welke tool welke helft beantwoordt, waarom een null-oordeel geen nee is en het patroon van 404 zonder redirect.
cannibalization-cleanupVind pagina’s die om dezelfde zoekopdracht concurreren, en waarom de top van de ernstrangschikking meestal merkruis is.
page-familiesLees een pagina en zijn vertalingen als één familie en koppel een verkeersverandering aan een hreflang- of canonicalwijziging.
site-audit-reviewPrijs, voer uit en interpreteer sitemap-site-audits om technische problemen op te lossen en interne linkwaarde te verbeteren.
backlinks-reviewBeoordeel of gemonitorde backlinks nog waarde hebben: wat “active” verbergt, verloren versus onbereikbaar en autoriteit vergelijken met concurrenten.

Geld#

SkillDoel
profitability-deep-diveRapporteer ecommercewinst eerlijk: controleer de kostendekking voordat je een marge noemt, want een niet-geconfigureerde kost leest als nul.
customer-valueLifetime value, cohorten en herhaalaankopen, en waarom het venster lang moet zijn.
paid-waste-reviewVind verspilde advertentie-uitgaven zonder winst te verzinnen, ook wanneer de conversiewaarde niet echt geld is.
seo-to-revenueBepleit organisch werk in geld in plaats van klikken, nadat je hebt gecontroleerd of de kanaaldata om omzet toe te schrijven bestaat.

Operatie en deliverables#

SkillDoel
platform-onboardingKoppel een dataplatform aan een domein en importeer de historie: de keten van offerte en bevestiging en waar geld wordt vastgelegd.
uptime-setupStel monitors, meldingen, heartbeats, onderhoudsvensters en een statuspagina in zonder half geconfigureerde standaardwaarden.
availability-reviewBeantwoord “was de site up, wat ging stuk en ligt er nu iets plat”, inclusief de kalendermaandregels van het SLA-rapport.
recurring-reportsMaak een wekelijks SEO- of maandelijks ecommercerapport dat vergelijkbaar is met het vorige: vaste vensters, vaste tools, voorbehouden meegenomen.

Wat een skill in de praktijk verandert#

Twee voorbeelden van wat de playbooks opvangen dat de toolschema’s niet kunnen:

  • De verdeling per provider verbergt stille engines. De verdeling per platform op het dashboard toont alleen engines die je aanhaalden. ai-visibility-audit stuurt de agent naar get_prompt_detail, dat voor elke engine toont of hij liep en of hij je aanhaalde, zodat “24% zichtbaarheid” wordt: “aangehaald door Perplexity, genegeerd door ChatGPT”. Zie ontbrekende enginedata.
  • Niet gekoppeld is niet nul. using-amicited laat de agent controleren of een platform is gekoppeld voordat hij meldt dat er geen data is, en naar Data Sources linken wanneer dat niet zo is.

Noem de skill in je verzoek wanneer je de vraag kent: “Use the traffic-drop-triage skill to explain last week’s drop on example.com.” De agent leest eerst het playbook en volgt de volgorde ervan. De pagina recipes heeft kant-en-klare prompts.

Gerelateerd#