schema-markup

Überblick über den schema-markup Skill

Was der schema-markup Skill leistet

Der schema-markup Skill hilft dir dabei, strukturierte Daten auf echten Seiten hinzuzufügen, zu korrigieren oder zu modernisieren – mit gültigen schema.org-Mustern, einem klaren Fokus auf JSON-LD und auf Rich-Result-Chancen, die in Google sichtbar werden können. Besonders nützlich ist er, wenn du bereits weißt, welche Seite du auszeichnen willst, aber schneller entscheiden möchtest, welcher Schema-Typ passt, welche Properties erforderlich sind und wie ein sofort implementierbares Code-Beispiel aussehen sollte.

Für wen sich schema-markup lohnt

Dieser schema-markup Skill passt gut zu SEO-Teams, Content-Marketing-Teams, Webentwicklern und Website-Betreibern, die strukturierte Daten sauber ausrollen wollen, ohne sich mühsam durch die Dokumentation zu rätseln. Besonders sinnvoll ist er für:

• Marketing-Websites und SaaS-Homepages
• Blog- und Artikel-Templates
• Produkt-, Software-, FAQ-, Event- und Local-Business-Seiten
• Teams, die fehlerhaftes oder unvollständiges Markup bereinigen

Der eigentliche Anwendungsfall

Die meisten Nutzer suchen keine Theorieeinführung in strukturierte Daten. Sie müssen schnell praktikable Fragen beantworten:

• Welcher Schema-Typ passt zu dieser Seite?
• Lassen sich mehrere Schema-Typen kombinieren?
• Welche Properties lohnen sich sofort?
• Was lässt sich sicher implementieren, ohne zu viel zu behaupten?
• Welches JSON-LD sollte heute in das Seitentemplate?

Der Skill ist genau auf diese Entscheidungen ausgelegt – nicht nur auf eine Liste von Schema-Typen.

Was diesen schema-markup Skill besonders macht

Der größte Unterschied ist, dass der Skill zu präzisem, seitenpassendem Markup führt, statt nach dem Muster „so viel Schema wie möglich“ zu arbeiten. Im Repository gibt es außerdem die hilfreiche Datei references/schema-examples.md mit konkreten Beispielen für gängige Typen wie Organization, WebSite, Article, Product, SoftwareApplication, FAQPage, HowTo, BreadcrumbList, LocalBusiness und Event. Dadurch ist der Skill deutlich handlungsorientierter als ein generischer Prompt.

Die wichtigsten Grenzen vor der Installation

Das ist weder ein Crawler noch ein Validator oder ein Live-Page-Scanner. Der schema-markup Skill ist auf die Seitenfakten angewiesen, die du lieferst. Wenn deine Eingaben unklar sind, kann das Ergebnis zwar sauber wirken, aber für Eligibility oder Implementierung trotzdem falsch sein. Außerdem liegt der Schwerpunkt auf Auswahl und Generierung von Markup, nicht auf einer umfassenden technischen SEO-Diagnose.

So nutzt du den schema-markup Skill

schema-markup Skill installieren

Installiere den Skill aus dem Repo mit:

npx skills add https://github.com/coreyhaines31/marketingskills --skill schema-markup

Wenn du den Skill vor der Installation bewerten möchtest, prüfe zuerst:

• skills/schema-markup/SKILL.md
• skills/schema-markup/references/schema-examples.md
• skills/schema-markup/evals/evals.json

Diese drei Dateien zeigen fast alles, was für die Entscheidung wichtig ist: Trigger-Bedingungen, Erwartungen an die Ausgabe und Beispielmuster.

Diese Dateien solltest du zuerst lesen

Starte in dieser Reihenfolge:

1. SKILL.md für Workflow und Entscheidungsregeln
2. references/schema-examples.md für kopierbare JSON-LD-Muster
3. evals/evals.json, um zu sehen, wie „gute Ausgabe“ in der Praxis aussieht

Die Evals sind besonders hilfreich, weil sie das gewünschte Verhalten offenlegen: erst den Kontext prüfen, dann passende Schema-Typen auswählen, bei Bedarf @graph verwenden, vollständiges JSON-LD ausgeben und eine Validierung empfehlen.

Bestes Eingabeformat für schema-markup

Der schema-markup Skill funktioniert am besten, wenn du Fakten auf Seitenebene lieferst und nicht nur „füge Schema hinzu“. Dazu gehören:

• Seiten-URL oder Seitentyp
• Zweck der Seite
• sichtbare Entitäten auf der Seite
• Art des Unternehmens
• angestrebtes Rich Result, falls vorhanden
• vorhandenes Schema oder bestehende Fehler
• CMS oder Framework
• Felder, die du tatsächlich befüllen kannst

Eine schwache Anfrage:

• „Add schema markup for SEO.“

Eine starke Anfrage:

• „Create JSON-LD for our SaaS homepage. We are a project management platform. Visible elements include company name, logo, product overview, customer logos, pricing link, and site search. We want Organization, WebSite, and the most appropriate product-related type. We deploy in Next.js and can inject one script in the layout.”

Aus einem groben Ziel einen brauchbaren Prompt machen

Ein guter schema-markup Prompt sollte vier Ergebnisse anfordern:

1. empfohlene Schema-Typen
2. Begründung für jede Auswahl
3. vollständiges JSON-LD
4. Hinweise zu Validierung und Implementierung

Beispiel für eine sinnvolle Prompt-Struktur:

• „Use the schema-markup skill.”
• „First determine the page type and rich result eligibility.”
• „Then recommend the minimal correct schema set.”
• „Generate production-ready JSON-LD.”
• „Flag any claims that are unsupported by visible content.”
• „Tell me where to place it in our template.”

Mit diesem Framing erhältst du verlässlichere Ergebnisse, als wenn du nur nach Beispielcode fragst.

Seitentypen, die der schema-markup Skill gut abdeckt

Auf Basis der Beispiele und Evals im Repository ist der schema-markup Skill besonders stark bei:

• Homepage-Organization und WebSite
• Blog-/Artikel-Markup
• Product und SoftwareApplication
• FAQPage
• HowTo
• BreadcrumbList
• LocalBusiness
• Event
• gemischten Seiten-Implementierungen mit @graph

Wenn sich deine Seite klar einem dieser Fälle zuordnen lässt, ist die Einführung unkompliziert.

Wann du @graph in schema-markup verwenden solltest

Nutze @graph, wenn eine Seite berechtigterweise mehrere Entitäten oder Seitenrollen enthält, zum Beispiel:

• Homepage mit Organization + WebSite
• SaaS-Homepage mit Organization + WebSite + SoftwareApplication
• Artikelseite mit Article + BreadcrumbList

Das ist wichtig, weil viele Teams Markup entweder ungeschickt auf mehrere Scripts aufteilen oder einen Typ mit unpassenden Properties überladen. Die Beispiele und Eval-Erwartungen im Skill sprechen klar für eine sauberere Modellierung mit mehreren Typen.

Praktischer schema-markup Workflow für SEO-Content

Ein praxistauglicher schema-markup Workflow sieht so aus:

1. den primären Zweck der Seite bestimmen
2. prüfen, welche Inhalte tatsächlich sichtbar sind
3. das kleinste gültige Schema-Set auswählen
4. JSON-LD erzeugen
5. im Template oder Seiten-Component implementieren
6. in Google Rich Results Test und Schema.org Validator validieren
7. das Markup nach der Veröffentlichung mit dem Live-Content abgleichen

Für SEO-Content-Teams verhindert das den häufigen Fehler, Rich-Result-orientiertes Markup einzubauen, das nicht zur tatsächlich gerenderten Seite passt.

Umsetzungstipps, die die Ausgabequalität spürbar verbessern

Ein paar zusätzliche Angaben verbessern das Ergebnis deutlich:

• canonical URL, Logo-URL und Bild-URLs angeben
• klar sagen, ob Bewertungen, Preise oder FAQs wirklich sichtbar sind
• angeben, ob die Seite transaktional, redaktionell, navigational oder lokal ist
• Framework-Einschränkungen wie Next.js, WordPress oder head-Script-Injection nennen
• dem Skill sagen, ob das Markup eher minimal oder umfassend sein soll

Ohne diese Details kann das Modell zwar den richtigen Typ wählen, aber die Property-Abdeckung bleibt oft zu schwach.

Validierungsschritte nach der schema-markup Installation

Nach dem Erzeugen des Markups solltest du validieren mit:

• Google Rich Results Test
• Schema.org Validator

Prüfe anschließend manuell:

• jedes ausgezeichnete Feld existiert tatsächlich auf der Seite
• URLs sind absolut
• Datumsangaben haben gültige Formate
• Bilder sind crawlbar
• mehrere Entitäten werden nicht inkonsistent über verschiedene Templates hinweg dupliziert

Das Repository setzt wiederholt auf Genauigkeit vor Vollständigkeit – und genau das ist die richtige Haltung bei der Einführung.

Typische, repository-gestützte Muster zum Übernehmen

Die mitgelieferte Beispieldatei lohnt sich als Pattern Library, besonders für:

• Organization mit sameAs und contactPoint
• WebSite mit SearchAction
• vollständige FAQ-Verschachtelung für Fragen und Antworten
• Setups für produktähnliche und softwarebezogene Entitäten
• ein Next.js-Implementierungsbeispiel

Der schema-markup Leitfaden ist damit nicht nur konzeptionell, sondern auch direkt als Starter-Kit nutzbar.

schema-markup Skill FAQ

Ist schema-markup besser als ein normaler AI-Prompt?

In der Regel ja, wenn du implementierungsreifes Markup willst. Ein normaler Prompt kann syntaktisch gültiges JSON-LD erzeugen, aber trotzdem den falschen Typ wählen, wichtige Properties auslassen oder Dinge auszeichnen, die auf der Seite gar nicht existieren. Der schema-markup Skill ist klarer auf Seiten-Fit, Genauigkeit und die sinnvolle Kombination mehrerer Schemas ausgerichtet.

Ist der schema-markup Skill einsteigerfreundlich?

Ja, wenn du die Seite klar beschreiben kannst. Du brauchst kein tiefes schema.org-Wissen, um Nutzen daraus zu ziehen. Anfänger müssen aber trotzdem belastbare Seitenfakten liefern. Der Skill ist keine Magie; fehlende Unternehmensdetails kann er nicht sicher erraten.

Kann schema-markup bei bestehendem fehlerhaften Markup helfen?

Ja. Das ist sogar einer der besten Anwendungsfälle. Gib das aktuelle Markup, den Seitentyp und den tatsächlich sichtbaren Inhalt an. Bitte den Skill dann, Abweichungen zu identifizieren, nicht belegbare Properties zu entfernen und das JSON-LD sauber neu zu schreiben.

Garantiert schema-markup Rich Results?

Nein. Der schema-markup Skill kann Eligibility und Umsetzungsqualität verbessern, aber Google entscheidet, ob Rich Results tatsächlich ausgespielt werden. Korrektes Markup, Seitenqualität, Inhaltstyp und Suchnachfrage spielen dabei alle eine Rolle.

Wann sollte ich schema-markup nicht verwenden?

Verlasse dich nicht allein auf diesen Skill, wenn du Folgendes brauchst:

• ein vollständiges technisches SEO-Audit
• Live-Site-Crawling in größerem Maßstab
• Ranking-Diagnosen
• JavaScript-Rendering-Analysen
• eine umfassende Content-Strategie

Der Skill ist am stärksten bei Entscheidungen zu strukturierten Daten auf Seitenebene, nicht bei ganzheitlichem SEO-Troubleshooting für komplette Websites.

Ist schema-markup für SaaS- und Marketing-Websites nützlich?

Ja. Die Evals weisen ausdrücklich auf Homepage-Anwendungsfälle wie Organization, WebSite und eine Modellierung im Stil von SoftwareApplication hin. Dadurch ist der Skill für moderne B2B- und SaaS-Teams relevanter als Schema-Guides, die sich fast nur auf E-Commerce konzentrieren.

So verbesserst du den schema-markup Skill

Gib schema-markup die Seitenfakten, die es nicht selbst ableiten kann

Der schnellste Weg zu besseren Ergebnissen ist, Folgendes bereitzustellen:

• exakter Zweck der Seite
• sichtbare Elemente
• Markenname und URLs
• Autor-, Publisher-, Datums-, Preis-, Bewertungs-, FAQ- oder Event-Daten, falls relevant
• was du rechtlich oder technisch behaupten kannst – und was nicht

Das reduziert Fehlannahmen und verbessert die Vollständigkeit der Properties.

Bitte zuerst um eine Schema-Entscheidung, dann erst um Code

Eine bessere Prompt-Reihenfolge ist:

1. „Decide the correct schema types.”
2. „Explain why each fits.”
3. „List missing data needed for a complete implementation.”
4. „Then generate final JSON-LD.”

So fällt eine falsche Typwahl früh auf, und der schema-markup Skill wird auf Seiten mit gemischtem Zweck deutlich zuverlässiger.

Vermeide den größten Fehler: Overmarking

Der häufigste Schema-Fehler ist, Markup für Dinge hinzuzufügen, die auf der Seite nicht klar vorhanden sind. Beispiele:

• FAQPage für versteckte oder nicht nutzerseitig sichtbare FAQs
• Review oder Bewertungsdaten ohne sichtbaren Beleg
• Product auf allgemeinen Markenseiten ohne echte Produktdetails
• HowTo auf Seiten, die in Wirklichkeit Blogposts sind

Wenn du schema-markup zurückhaltend einsetzt, sind die Ergebnisse meist besser.

Verbessere Multi-Entity-Ausgaben mit expliziten Beziehungen

Wenn du mehrere Typen anforderst, beschreibe dem Skill, wie sie zusammenhängen:

• „This page is the company homepage”
• „The article belongs to this publisher”
• „The software application is the main product described here”
• „Breadcrumbs are rendered above the H1”

Das hilft dem Skill, saubereres @graph-Markup zu erzeugen statt unverbundener Entitäten.

Nutze die Beispieldatei als Qualitätsmaßstab

Bevor du das Ergebnis live stellst, vergleiche es mit references/schema-examples.md. Prüfe, ob dein Resultat die erwarteten Strukturmuster für den jeweiligen Typ enthält. Das ist eine der praktischsten Möglichkeiten, den schema-markup Einsatz zu verbessern, ohne ganz schema.org durcharbeiten zu müssen.

Nach dem ersten Entwurf iterieren, statt ihn roh zu übernehmen

Stelle nach dem ersten Output gezielte Nachfragen wie:

• „Strip this to only required and high-value recommended properties.”
• „Rewrite for a blog post rather than a generic article.”
• „Convert this to a single @graph block.”
• „Adapt this for Next.js server-rendered injection.”
• „Audit this against the visible page content and remove unsupported fields.”

Oft wird der schema-markup Skill erst in dieser zweiten Runde wirklich produktionsreif.

schema-markup mit Validierung und SERP-Realitätscheck kombinieren

Auch starkes JSON-LD sollte geprüft werden gegen:

• den tatsächlich gerenderten Seiteninhalt
• Validierungstools
• die Frage, ob das angestrebte Rich Result für diesen Seitentyp realistisch ist

Der beste schema-markup Workflow ist nicht „einmal generieren und einfügen“, sondern: „generieren, validieren, abgleichen, veröffentlichen“.