Dokumentation

KI-Agenten (MCP)

Playbook-Skills

Die 22 Playbooks, die der AmICited MCP-Server als Skill-Ressourcen mitliefert: welche Tools in welcher Reihenfolge aufzurufen sind und die Fallen, die eine selbstsichere Antwort falsch machen.

Tools sind das, was ein Agent erreichen kann. Skills sind die Anleitung, sie für eine echte Frage zu nutzen. Bei über 300 Tools ist das Schwierige selten, eines zu finden: Es ist zu wissen, dass „warum ist der Traffic gefallen“ sechs Berichte in einer bestimmten Reihenfolge braucht oder dass ein leerer E-Commerce-Bericht „nicht verbunden“ bedeuten kann statt „null Umsatz“.

Der AmICited MCP-Server liefert diese Playbooks als MCP-Ressourcen mit. Jedes wurde geschrieben, indem Agenten ohne Playbook schwierige Fragen gegen den Live-Server gestellt wurden, jede Sackgasse und falsche Annahme protokolliert und diese Fehler in Anweisungen verwandelt wurden. Jeder in einem Skill genannte Tool-Name wird bei jedem Build gegen das Live-Tool-Register geprüft, sodass ein Skill nie auf ein Tool zeigt, das nicht mehr existiert.

Wie Agenten sie finden#

Skills werden unter skill://<name>/SKILL.md ausgeliefert. Sie aufzulisten kostet einen Namen und eine Zeile pro Skill; der Inhalt wird nur abgerufen, wenn ein Agent ihn will.

  • Die Anweisungen des Servers, die bei der Verbindung an jeden Client gesendet werden, weisen den Agenten an, zuerst skill://using-amicited/SKILL.md zu lesen. Dieser Skill erklärt die Schleife finden, prüfen, ausführen und listet die anderen auf.
  • Viele Clients listen Ressourcen nie von selbst auf. Wenn Ihr Agent einen Skill nicht zu kennen scheint, nennen Sie ihn: „Lies skill://ai-visibility-audit/SKILL.md und prüfe dann example.com.“
  • Skills sind schreibgeschützter Text. Einen zu lesen zählt nicht auf das stündliche Limit für Tool-Aufrufe.

Konventionen#

SkillZweck
using-amicitedWie der Endpunkt gesteuert wird: das richtige Tool unter 300+ finden, es aufrufen und die Konventionen, die jeder andere Skill voraussetzt. Zuerst lesen.
report-windowsZeitfenster und Vergleichszeiträume über Berichte hinweg: die unterschiedlichen Argumentstile, die Regel gleicher Länge und wie Sie selbstsicher falsche Zahlen vermeiden.

KI-Sichtbarkeit und Wettbewerber#

SkillZweck
ai-visibility-auditDiagnostizieren, warum eine Marke in KI-Antworten zitiert wird oder nicht: welche Engines tatsächlich liefen, was die Kennzahl in der Kopfzeile verbirgt und vier Prüfungen, die eine Lücke erklären.
competitor-gap-analysisFinden, wo Wettbewerber KI-Antworten und Suche gewinnen, Sie aber nicht, und welche Lücken Sie zuerst angehen sollten.
competitor-content-gapsSitemap-Bereiche, Vokabular und Publikationslücken von Wettbewerbern finden, ohne unvollständige Aktualitätsdaten zu überzeichnen.
ai-fanout-queriesDie Suchen finden, die ein KI-Assistent gegen Ihre Website ausgeführt hat (die mit einem site:-Operator), und sie lesen, ohne null Klickrate für ein Problem zu halten.
prompt-set-designGetrackte Prompts für eine Domain hinzufügen: wie ein gutes Prompt-Set aussieht, die Tagging-Falle und warum nichts hier Ihnen die Credit-Kosten nennen kann.

Diagnose der organischen Suche#

SkillZweck
traffic-drop-triageHerausfinden, warum sich der organische Traffic bewegt hat: auf eine Suchanfrage oder Seite eingrenzen, die Stufe datieren und Indexierung, Ausfälle und Website-Änderungen ausschließen, bevor man Rankings verantwortlich macht.
did-our-change-workEine Website-Änderung mit dem korrelieren, was danach geschah, und warum eine leere Anmerkungshistorie kein Beleg für irgendetwas ist.
indexing-triageIndexierungsprobleme untersuchen: welches Tool welche Hälfte beantwortet, warum ein Null-Urteil kein Nein ist und das Muster 404 ohne Weiterleitung.
cannibalization-cleanupSeiten finden, die um dieselbe Suchanfrage konkurrieren, und warum die Spitze des Schweregrad-Rankings meist Marken-Rauschen ist.
page-familiesEine Seite und ihre Übersetzungen als eine Familie lesen und eine Traffic-Veränderung mit einer Änderung an hreflang oder Canonical verknüpfen.
site-audit-reviewSitemap-Site-Audits bepreisen, ausführen und auswerten, um technische Probleme zu beheben und das interne Link Equity zu verbessern.
backlinks-reviewBeurteilen, ob überwachte Backlinks noch Wert tragen: was „aktiv“ verbirgt, verloren versus nicht erreichbar und Autorität mit Wettbewerbern vergleichen.

Geld#

SkillZweck
profitability-deep-diveE-Commerce-Gewinn ehrlich berichten: Kostenabdeckung prüfen, bevor eine Marge genannt wird, denn eine nicht konfigurierte Kostenposition liest sich als null.
customer-valueCustomer Lifetime Value, Kohorten und Wiederkäufe, und warum das Fenster lang sein muss.
paid-waste-reviewVerschwendete Werbeausgaben finden, ohne Gewinn zu erfinden, auch wenn der Conversion-Wert tatsächlich kein Geld ist.
seo-to-revenueOrganische Arbeit in Geld statt in Klicks begründen, nachdem geprüft wurde, dass die Kanaldaten zur Umsatzzuordnung existieren.

Betrieb und Ergebnisse#

SkillZweck
platform-onboardingEine Datenplattform mit einer Domain verbinden und ihren Verlauf importieren: die Kette aus Angebot und Bestätigung und wo Geld gebunden wird.
uptime-setupMonitore, Benachrichtigungen, Heartbeats, Wartungsfenster und eine Statusseite ohne halb konfigurierte Standardwerte einrichten.
availability-review„War die Website oben, was ist kaputtgegangen und ist gerade etwas down“ beantworten, einschließlich der Kalendermonatsregeln des SLA-Berichts.
recurring-reportsEinen wöchentlichen SEO- oder monatlichen E-Commerce-Bericht erstellen, der mit dem letzten vergleichbar ist: feste Zeitfenster, feste Tools, mitgeführte Einschränkungen.

Was ein Skill in der Praxis ändert#

Zwei Beispiele dafür, was die Playbooks auffangen und die Tool-Schemas nicht:

  • Die Anbieter-Aufschlüsselung verbirgt stumme Engines. Die Aufschlüsselung nach Plattform im Dashboard listet nur Engines, die Sie zitiert haben. ai-visibility-audit schickt den Agenten zu get_prompt_detail, das für jede Engine zeigt, ob sie lief und ob sie Sie zitiert hat, sodass aus „24 % Sichtbarkeit“ „von Perplexity zitiert, von ChatGPT ignoriert“ wird. Siehe Fehlende Engine-Daten.
  • Nicht verbunden ist nicht null. using-amicited lässt den Agenten prüfen, ob eine Plattform verbunden ist, bevor er meldet, dass sie keine Daten hat, und Sie auf Datenquellen verlinken, wenn nicht.

Nennen Sie den Skill in Ihrer Anfrage, wenn Sie die Frage kennen: „Nutze den Skill traffic-drop-triage, um den Einbruch der letzten Woche auf example.com zu erklären.“ Der Agent liest zuerst das Playbook und folgt seiner Reihenfolge. Die Seite Rezepte hat fertige Prompts.

Verwandte Themen#