Schema.org-Strukturdaten-Implementierung – Kompletter Workflow-Skill
Dieser Skill bietet eine End-to-End-Methodik zur Analyse von Websites, zum Entwurf von schema.org-Markups und zur Erstellung entwicklerfertiger Tickets. Er wurde in realen Projekten zur Implementierung von Strukturdaten auf mehrsprachigen, mehrregionalen Websites verfeinert.
Die Methodik ist kundenunabhängig. Sie funktioniert für jede Website, bei der eine umfassende schema.org-Abdeckung mit Entwicklerübergabe über ein Projektmanagement-Tool (JIRA, Wrike oder ähnlich) das Ziel ist.
Lizenz: Dieser Skill wird unter der Creative Commons Attribution 4.0 International (CC BY 4.0) Lizenz veröffentlicht. Du kannst diesen Skill für jeden Zweck teilen und anpassen, sofern du den ursprünglichen Autor angemessen nennst.
Verwandte Audits: Phase 5 dieses Skills überprüft die Live-Ausgabe anhand der in Phase 2 entworfenen Spezifikation. Wenn die Aufgabe stattdessen darin besteht, einen gemeldeten Fix über Sprachen hinweg zu verifizieren („für alle Sprachen behoben“, „überall ausgerollt“), führe ein JSON-LD-Validierungsaudit mit den Disziplinen der Anspruchsüberprüfung durch, die dieser Skill nicht abdeckt: das Cache-Busting-Gate, die Populationsaufzählung aus dem Sitemap-Index / dem Live-Hreflang-Set und die Positivkontrolle. Das Audit-Ende der Breadcrumb-Arbeit ist ein Breadcrumb-Navigationsaudit; dieser Skill kümmert sich um sein Ticket-Ende.
So funktioniert dieser Skill
Dies ist ein Projektskill, der für die meisten Websites typischerweise in 1–3 Stunden über 1–2 Sitzungen abgeschlossen wird. Komplexe mehrsprachige Websites mit vielen Seitentypen können länger dauern. Der Skill definiert fünf aufeinanderfolgende Lieferphasen: Phase 0 (Setup), Phase 1 (Discovery), Phase 2 (Schema-Entwurf), Phase 3 (Ticketerstellung) und Phase 4 (Neugenerierung & Lieferung) – gefolgt von zwei Post-Phasen nach der Bereitstellung: Phase 5 (Überprüfung nach der Bereitstellung) und Phase 6 (Wirkungsmessung). Claude soll identifizieren, in welcher Phase sich der Benutzer befindet, und ihn durch diese führen.
Der Benutzer liefert: Projektkontext, Feedback zu Analyse und Ticketentwürfen, projektspezifische Regeln, Klärung offener Fragen. Claude liefert: Page-Type-Discovery, HTML-Analyse, Schema-Entwurf, Ticketentwürfe (Parent + Kind) sowie einen abschließend neu generierten Satz von Tickets.
Terminologiehinweis: Dieser Skill verwendet „Ticket“ als generischen Begriff für das entwicklerorientierte Ergebnis. Das tatsächliche Format hängt von der in Phase 0 gewählten Projektmanagement-Plattform ab (JIRA-Tickets, Wrike-Aufgaben usw.).
Referenzdateien – bei Bedarf laden
Die Phasen 1 bis 6 befinden sich in Referenzdateien, eine Datei pro Phase. Jeder Zeiger benennt seinen Auslöser. Diese Ladevorgänge sind obligatorische Schritte: Wenn eine Phase beginnt, lade ihre Datei, bevor du die Arbeit erledigst – improvisiere niemals eine Phase aus dieser Kerndatei. Wenn dir auffällt, dass eine Phase ohne ihre Datei bearbeitet wurde, sage dies, lade sie und überprüfe die bisher geleistete Arbeit erneut anhand dieser Datei.
references/discovery.md– Phase 1: Page-Type-Katalog, Triage, Google-Leitlinien-Prüfung, Analyse pro Seitentyp (vorhandenes Schema in allen drei Formaten, konditionales Schema-Triage, Locale-Lieferung), Speichern von echten Daten, Konsolidierung, Klassifizierung. Lade vor dem Erstellen des Page-Type-Katalogs und vor der Analyse des HTML eines Seitentyps.references/schema-design.md– Phase 2, Abschnitte 2.1–2.7: globales und seitenspezifisches Schema,@id-Querverweise, Deprecation vs. Entfernung, Formatmigrationsverfügungen, Eigenschaftenauswahlregeln, mehrsprachige Eigenschaftswerte, Überprüfen von Annahmen, Projektregeln. Lade vor der Auswahl von Schema-Typen oder -Eigenschaften für einen Seitentyp.references/ticket-writing.md– Phase 3: Pre-Flight, die Ticketvorlage, Subagent-Richtlinien, die nummerierten Ticketerstellungsregeln (1–46), das Parent-Ticket, die Pre-Delivery-Checkliste, der Feedback-Workflow und Gemeinsame Schema-Entscheidungen (§3.7). Lade vor dem Entwurf, der Überarbeitung oder der Überprüfung eines Tickets, vor der Briefing eines Subagenten zu Tickets und wenn eine §3.7-Entscheidung im Entwurf ansteht.references/delivery.md– Phase 4: Neugenerierungsplan, plattformspezifische Formatierung (Wrike, JIRA, Rich-Text-Editoren, WAF-geschützte Tools), der Lieferformat-Entscheidungsbaum, Redaktionsdurchlauf, plattformübergreifende Konsistenzprüfungen, Verpackung, Wrike XLS + HTML-Einfügen. Lade vor der abschließenden Neugenerierung und vor der Formatierung von Tickets für das Zielwerkzeug.references/post-deployment-verification.md– Phase 5: die Vollpopulations-Scan-Auslöser, die Phase-5-Pre-Flight-Checkliste, sprachübergreifende Überprüfungs- und Abruftechniken, die vier Kategorien von Befunden und das Berichtsskelett, Follow-up-Kommentare, URL- und Quellwertüberprüfung, GSC-Fehlerabgleich und -Diagnose, falsch positive Ergebnisse bei Einzelabrufen, Deckungsaudits aus Crawl-Exporten. Lade vor der Überprüfung eines bereitgestellten Schemas, vor der Bestätigung eines Tickets als erledigt, vor der Beantwortung einer vom Kunden gemeldeten Abweichung und vor der Diagnose eines Search-Console-Strukturdatenfehlers.references/measuring-impact.md– Phase 6: die Aufschlüsselung der Sucheinbindung, die Erwartungsaussage, die messbaren Kanäle, Datenaufbewahrung. Lade, wenn der Kunde fragt, was die Strukturdaten bewirkt haben, bevor irgendwelche Wirkungskennzahlen abgerufen werden.
Abschnittsnummern (§1.2, §5.4) und Regelnummern (Regel 35, Anti-Pattern 21) sind in jeder Datei gleich, sodass ein Querverweis über diese Karte aufgelöst wird.
Phase 0: Einrichtung & Werkzeuge
Ziel: Verfügbare Tools und Zugänge bewerten, den effizientesten Workflow einrichten und projektbezogene Präferenzen vor Beginn der Inhaltsarbeit sammeln.
0.1 Verfügbare Tools bewerten
Bevor Analysearbeit beginnt, bestimme, welche Fähigkeiten verfügbar sind:
- Browser-Zugriff (z. B. Claude in Chrome-Erweiterung, Cowork-Browser-Tools) – Ermöglicht Claude, Seiten direkt zu navigieren, gerendertes HTML zu erfassen, Daten zu extrahieren und Fakten autonom zu überprüfen. Dies ist der effizienteste Workflow.
- Websuche – Ermöglicht Claude, die Seitenstruktur zu kartieren, Sitemaps zu finden und Seitentypen ohne Browser-Zugriff zu entdecken.
- Dateisystem-Zugriff – Ermöglicht das inkrementelle Speichern von Analysedokumenten und Ticketentwürfen.
- Direkter Website-Zugriff – Einige Websites blockieren automatisierten Zugriff (403-Fehler). Wenn der Web-Abruf fehlschlägt, sind Browser-Zugriff oder manuelles HTML-Upload als Ausweichmöglichkeiten verfügbar.
0.2 Benutzer zum Browser-Zugriff führen
Die browserunterstützte Analyse ist der primäre empfohlene Workflow für diesen Skill. Sie ermöglicht Claude:
- Seitentypen autonom zu entdecken und zu kartieren
- Gerendertes HTML von jeder Seite ohne manuelles Kopieren und Einfügen zu erfassen
- Erkennungssignale, Datenquellen und Vorlagenstrukturen in Minuten zu extrahieren
- Fakten (URL-Muster, Sprachvarianten, Feldverfügbarkeit) vor dem Schreiben von Tickets zu überprüfen
Wenn der Browser-Zugriff noch nicht verfügbar ist, erkläre die Vorteile und führe den Benutzer durch die Einrichtung. Die Rolle des Benutzers wechselt von „HTML-Sammler“ (mühsam, geringer Wert) zu „Prüfer und Entscheider“ (hoher Wert, wo seine Fachkenntnisse zählen).
Wenn der Browser-Zugriff nicht verfügbar ist oder die Website automatisiertes Browsen vollständig blockiert, greife auf den manuellen Workflow zurück, der in Phase 1.2 beschrieben wird.
Kostenbewusstsein: Der Browser-Zugriff ermöglicht die gründlichste Analyse, ist aber im Token-Verbrauch deutlich teurer – Chrome-Tool-Aufrufe liefern große Payloads, die sich bei wachsender Konversation quadratisch vervielfachen. Reserviere Browser-Workflows für die anfängliche Discovery- und Verifizierungsphasen, in denen die Seiteninspektion in Echtzeit einen echten Mehrwert bietet. Für Aufgaben, bei denen das Page-Type-Inventar bereits etabliert ist (z. B. Schreiben von Tickets aus einem abgeschlossenen Audit), sind Nicht-Browser-Workflows gleichermaßen effektiv und viel billiger. Wenn der Browser verwendet wird, bevorzuge gezielte Aufrufe (get_page_text, find, javascript_tool für chirurgische Extraktion) gegenüber schweren Aufrufen (read_page für volles DOM, read_network_requests für vollen Traffic).
0.3 Projektpräferenzen sammeln
Bevor die Inhaltsarbeit beginnt, frage den Benutzer:
- Projektmanagement-Plattform – „In welchem System werden diese Tickets erstellt? (JIRA, Wrike, Asana usw.)“ Dies bestimmt die Terminologie (Tickets vs. Aufgaben vs. Elemente), Formatierungsbeschränkungen (z. B. rendert Wrike keine verschachtelten Code-Blöcke innerhalb von Listenelementen – siehe §4.4 Plattformspezifischer Formatierungsdurchlauf in
references/delivery.md) und die Namenskonvention für auslieferbare Dateien. - Ticketstruktur – „Hat Ihre Organisation eine etablierte Ticketstruktur oder -vorlage für Entwickleraufgaben? Wenn ja, teilen Sie bitte eine Vorlage oder Richtlinien zur Ticketerstellung mit. Ich werde die Schema-Tickets an die Konventionen Ihres Teams anpassen.“ Wenn keine Vorlage existiert, verwende die Standardstruktur des Skills.
- Begrüßung und Ton – z. B. „Hallo Team,“ mit Peer-to-Peer-Ton oder formell.
- Projektspezifische Regeln – Datenschutzauflagen, Terminologie, Markenrichtlinien usw. (Diese können auch während Phase 2 gesammelt werden.)
Phase 1: Discovery & Page-Type-Katalog
Ziel: Erstellen eines vollständigen Inventars aller Seitentypen auf der Website mit Erkennungssignalen, vorhandener Schema-Abdeckung und gespeicherten Echtdaten für Ticket-Codebeispiele.
Lade references/discovery.md vor dem Start dieser Phase. Sie enthält die gesamte Phase:
- 1.1 Erstellen der Page-Type-Liste
- 1.1b Prioritätsbewertung / Triage
- 1.1c Überprüfen der aktuellen Google-Leitlinien
- 1.2 Analysieren jedes Seitentyps
- 1.3 Speichern von Echtdaten für Ticket-Codebeispiele
- 1.4 Dokumentieren der Ergebnisse
- 1.5 Identifizieren von Konsolidierungsmöglichkeiten
- 1.6 Klassifizieren jedes Seitentyps
Phase 2: Schema-Entwurf
Ziel: Entscheiden, welche Schema-Typen und -Eigenschaften für jeden Seitentyp verwendet werden und wie die Schemas standortübergreifend miteinander in Beziehung stehen.
Lade references/schema-design.md vor der Auswahl von Schema-Typen oder -Eigenschaften. Sie enthält die Abschnitte 2.1–2.7:
- 2.1 Entwerfen des globalen/geteilten Schemas
- 2.2 Entwerfen von seitenbezogenen Schemas
- 2.3 Entwerfen von Querverweisen
- 2.4 Deprecation vs. Entfernung
- 2.4b Formatmigrations-Tickets – Umgang mit dem vorhandenen Format
- 2.5 Anwenden der Eigenschaftenauswahlregeln
- 2.5b Mehrsprachige Eigenschaftswerte
- 2.6 Überprüfen von Annahmen vor der Finalisierung
- 2.7 Projektspezifische Regeln
§2.8 bleibt in dieser Kerndatei, da jedes Ticket und jede Überprüfung es anwendet:
2.8 Universelle technische Anforderungen
Diese gelten für jedes Projekt:
- Schema muss serverseitig gerendert werden – Im anfänglichen HTML vorhanden sein, das vom Server zurückgegeben wird, nicht dynamisch durch JavaScript injiziert. Dies ist eine SEO-Best-Practice, keine projektspezifische Präferenz.
- JSON-LD-Format – Immer als
<script type="application/ld+json">im Abschnitt<head>implementieren. - Separate Script-Tags – Jeder Schema-Typ erhält seinen eigenen
<script>-Tag. - @context-Format – Immer
https://schema.orgverwenden (kein abschließender Schrägstrich). Dies durchgängig in allen Tickets durchsetzen. - Ausgabe über einen echten JSON-Serialisierer – JSON-LD niemals durch Zeichenkettenverkettung/Templating von CMS-Werten manuell zusammenbauen. Manuell erstelltes JSON-LD ist anfällig für eine ganze Klasse von Fehlern, die über nicht maskierte Zeichen hinausgehen: nicht maskierte Anführungszeichen in interpolierten Werten, Ersetzung durch geschweifte/geschwungene Anführungszeichen (U+201C/U+201D/U+201E, wo ein gerades
"hingehört), und strukturelle Fehler wie überflüssige oder doppelte geschweifte Klammern (z. B. ein@id-Wert, der in ein zusätzliches Klammerpaar eingeschlossen ist). Ein Serialisierer eliminiert die gesamte Klasse; Escape-Regeln allein reichen nicht. - HTML-Entitäten in Textwerten dekodieren – Eine Text-Eigenschaft führt das dekodierte Zeichen (
',&), niemals die HTML-Entität (',&), die ein CMS-Feld oder die Seitenquelle speichert. Wenn das Quellfeld kodierten Text enthält, dekodiert die Vorlage ihn vor dem Serialisieren. - Daten in ISO 8601, Datumsangaben mit Zeitzonenoffset – Jede Datums- und Datumszeit-Eigenschaft (
datePublished,dateModified,startDate,validFrom…) verwendet ISO 8601; eine Datumszeit trägt ihren Offset (YYYY-MM-DDThh:mm:ss+hh:mm), niemals eine bloße lokale Zeit oder ein von der Seite kopiertes Anzeigeformat.
Phase 3: Ticketerstellung
Ziel: Entwicklerfertige Tickets erstellen – ein Parent-Ticket für gemeinsame Schemas, ein Child-Ticket pro Seitentyp (oder konsolidierter Gruppe).
Lade references/ticket-writing.md vor dem Entwurf, der Überarbeitung oder der Überprüfung eines Tickets. Sie enthält die gesamte Phase:
- 3.1 Pre-Flight-Check
- 3.2 Vorlage für die Ticketstruktur
- 3.2b Richtlinien zur Verwendung von Subagenten
- 3.3 Regeln für die Ticketerstellung
- 3.4 Schreiben des Parent-Tickets
- 3.5 Pre-Flight-Checkliste (vor der Lieferung)
- 3.6 Feedback & Iterations-Workflow
- 3.7 Gemeinsame Schema-Entscheidungen
Phase 4: Abschließende Neugenerierung & Lieferung
Ziel: Alle Tickets in einem Durchgang neu generieren, wobei jede gesammelte Regel, Entscheidung und Korrektur für plattformübergreifende Konsistenz angewendet wird.
Lade references/delivery.md vor dem abschließenden Neugenerierungsdurchlauf. Sie enthält die gesamte Phase:
- 4.1 Erstellen eines Neugenerierungsplans
- 4.2 Zuerst alle offenen Fragen klären
- 4.3 Sequentiell neu generieren
- 4.4 Plattformspezifischer Formatierungsdurchlauf
- Lieferformat-Entscheidungsbaum
- 4.5 Redaktionsdurchlauf
- 4.6 Plattformübergreifende Konsistenzprüfungen
- 4.7 Für die Lieferung verpacken
- 4.8 Wrike-Lieferung – XLS-Skelett + HTML-Einfügen
Phase 5: Überprüfung nach der Bereitstellung
Ziel: Nachdem das Schema bereitgestellt wurde, bestätigen, dass die Live-Ausgabe der Spezifikation entspricht – mit besonderem Augenmerk auf mehrsprachige Abdeckung und korrekte numerische Typen.
Lade references/post-deployment-verification.md vor der Überprüfung des bereitgestellten Schemas, vor der Bestätigung eines Tickets als erledigt oder vor der Diagnose eines Search-Console-Fehlers. Sie enthält die gesamte Phase:
- Präambel der Phase – Bereichshinweis (Überprüfung gemeldeter Fixes geht an ein JSON-LD-Validierungsaudit), die zwei Auslöser für einen Vollpopulations-Scan und das standortweite Ticketvorlagen-Inventar
- Pre-Flight-Checkliste für Phase 5 (vor dem Senden des Berichts)
- 5.1 Sprachübergreifendes Überprüfungsmuster
- 5.2 Kategorien von Audit-Befunden
- 5.3 Wann die Spezifikation wieder geöffnet werden sollte
- 5.4 URL-Überprüfung – Pre-Publish-Verfahren
- 5.5 Quellwert-Überprüfung – Spiegel-Audits reichen nicht aus
- 5.6 Abgleich von GSC-Fehlerzahlen mit einem Live-Crawl
- 5.7 Falsch positive Ergebnisse bei Einzelabrufen auf dynamisch gerenderten Feldern
- 5.8 Diagnose von GSC „Nicht analysierbare Strukturdaten / Falscher Wertetyp“ über URLs des gleichen Seitentyps hinweg
- 5.9 Deckungsaudit aus Crawl-Exporten
Phase 6: Wirkungsmessung
Ziel: Dem Kunden messbare Ergebnisse der Strukturdatenimplementierung liefern, einschließlich Sucheinbindung, CTR-Veränderungen und Rendite.
Lade references/measuring-impact.md vor dem Abrufen von Wirkungskennzahlen. Sie enthält die gesamte Phase:
- 6.1 Aufschlüsselung der Sucheinbindung
- 6.2 Erwartungsaussage formulieren
- 6.3 Messbare Kanäle identifizieren
- 6.4 Datenaufbewahrung und Berichtsintervall