seo-audit

Überblick über den seo-audit skill

Was der seo-audit skill macht

Der seo-audit skill hilft einem Agenten, eine strukturierte SEO-Prüfung durchzuführen, statt sofort in generische Empfehlungen zu springen. Er ist dafür gedacht, herauszufinden, warum eine Website in der organischen Suche unterdurchschnittlich performt, was zuerst geprüft werden sollte und wie sich die Erkenntnisse in einen priorisierten Maßnahmenplan überführen lassen.

Für wen sich dieser seo-audit skill lohnt

Besonders geeignet für:

• Marketer und Gründer, die einen wiederholbaren Workflow für SEO-Diagnosen wollen
• Agenten, die SaaS-, Content- oder Unternehmenswebsites prüfen
• Teams, die mit Traffic-Einbrüchen, Indexierungsproblemen, schwachen Rankings oder unklaren On-Page-Schwächen zu tun haben
• alle, die einen belastbareren seo-audit guide als einen einmaligen Prompt möchten

Weniger geeignet für:

• Nutzer, die ausschließlich Details zur Schema-Implementierung suchen
• Nutzer, die programmatische SEO-Seitengenerierung umsetzen
• Nutzer, die auf AI Search Optimization statt auf klassische Search Audits fokussiert sind

Die eigentliche Aufgabe dahinter

Die meisten Menschen, die nach einem SEO-Audit fragen, wollen nicht einfach nur eine Checkliste. Sie möchten wissen:

• was Rankings wahrscheinlich blockiert
• welche Belege zuerst gesammelt werden sollten
• was man ohne ausreichenden Zugriff nicht behaupten sollte
• welche Probleme aktuell wirklich Priorität haben

Dieser Skill ist nützlich, weil er eine feste Audit-Reihenfolge erzwingt: zuerst Crawlability und Indexierung, dann technische Grundlagen, On-Page-Optimierung, Content-Qualität sowie Autorität und Links. Diese Reihenfolge verhindert, dass Empfehlungen mit geringem Hebel schwerwiegendere Probleme bei der Website-Gesundheit verdrängen.

Was diesen skill von einem generischen Prompt unterscheidet

Die praktischen Unterschiede sind:

• er weist den Agenten an, zuerst den Produktmarketing-Kontext zu prüfen, falls eine lokale Kontextdatei vorhanden ist
• er fordert fehlenden Business- und Website-Kontext an, bevor blind auditiert wird
• er nutzt eine klare Prioritätenlogik für Findings
• er warnt ausdrücklich vor einer Einschränkung bei der Erkennung von Schema Markup, wenn nur abgerufener HTML-Code vorliegt
• er erwartet eine Berichtsstruktur mit Executive Summary und priorisierten Maßnahmen

Diese Details sind wichtig, weil viele schwache SEO-Audits selbstsicher klingen, dabei aber Indexierungsgrundlagen überspringen oder auf Basis begrenzter Zugriffe mehr behaupten, als tatsächlich verifiziert werden kann.

So verwendest du den seo-audit skill

seo-audit install-Kontext

Installiere den Skill aus dem Repo mit:

npx skills add https://github.com/coreyhaines31/marketingskills --skill seo-audit

Dadurch wird der Skill aus skills/seo-audit im Repository coreyhaines31/marketingskills hinzugefügt. Innerhalb des Skills selbst gibt es keinen separaten Installer, daher ist der praktische seo-audit install-Schritt einfach der oben gezeigte Standard-Skills-Befehl.

Diese Dateien vor der ersten Nutzung lesen

Für einen schnellen, signalstarken Leseweg im Repository öffne:

1. skills/seo-audit/SKILL.md
2. skills/seo-audit/evals/evals.json
3. skills/seo-audit/references/ai-writing-detection.md

Warum in dieser Reihenfolge:

• SKILL.md liefert Workflow und Umfang des Audits
• evals/evals.json zeigt, wie gute Ausführung konkret aussieht
• die Schreibreferenz hilft dabei, Audit-Ausgaben lesbarer und weniger synthetisch zu formulieren, was wichtig ist, wenn du Ergebnisse mit Kunden oder Stakeholdern teilst

Welche Eingaben der skill braucht

Die Qualität der seo-audit usage hängt stark von den Angaben ab, die du mitgibst. Mindestens solltest du liefern:

• die Website-URL
• den Seitentyp: SaaS, E-Commerce, Publisher, lokales Unternehmen, Marketplace usw.
• das SEO-Ziel: mehr Leads, mehr Non-Brand-Traffic, Erholung nach einem Einbruch, bessere Rankings für wichtige Seiten
• Ziel-Keywords oder Themen-Cluster
• bekannte Probleme: Migration, Redesign, CMS-Wechsel, Traffic-Verlust, Beschwerden zur Indexierung
• den Scope: gesamte Website, Bereich, Template oder einzelne Seite
• das Zugriffslevel: nur öffentliches Web, Search Console-Daten, Analytics, Crawl-Exporte, Wettbewerber-URLs

Wenn diese Angaben fehlen, bleibt der Skill zwar nutzbar, aber die Ausgabe verlagert sich stärker auf sichtbare On-Page-Checks und allgemeine technische Heuristiken.

Vor Rückfragen erst lokalen Kontext prüfen

Einer der nützlichsten, aber leicht zu übersehenden Teile dieses seo-audit skill ist die Anweisung, zuerst .agents/product-marketing-context.md oder .claude/product-marketing-context.md zu lesen, falls vorhanden. Wenn du den Skill innerhalb eines Projekt-Repos verwendest, lassen sich so unnötige Rückfragen zu Zielgruppe, Positionierung und Prioritätsseiten vermeiden.

Das verbessert die Audit-Qualität, weil SEO-Empfehlungen deutlich besser werden, wenn sie auf das tatsächliche Produkt, den Funnel und den Markt bezogen sind.

Aus einer groben Anfrage einen starken Audit-Prompt machen

Schwache Eingabe:

• "Do an SEO audit of our site"

Stärkere Eingabe:

• "Run an SEO audit for https://example.com. We are a B2B SaaS company selling payroll software for remote teams. Primary goal is demo signups from non-brand organic search. Priority keywords are global payroll software, employer of record payroll, and multi-country payroll. Organic traffic dropped about 25% after a site redesign six weeks ago. Focus on crawlability, indexation, title and heading quality, internal linking, and content gaps on money pages. If something cannot be verified from public fetch alone, say so clearly."

Warum das besser funktioniert:

• es liefert Business-Kontext
• es definiert Erfolg
• es grenzt den Scope ein
• es fördert evidenzbasierte Unsicherheit statt vorgetäuschter Sicherheit

Die vorgesehene Audit-Reihenfolge einhalten

Ein häufiger Fehler ist, mit Copy-Anpassungen zu beginnen. Dieser Skill ist deutlich wertvoller, wenn er in der vorgesehenen Reihenfolge genutzt wird:

1. Crawlability und Indexierung
2. Technische Grundlagen
3. On-Page-Optimierung
4. Content-Qualität
5. Autorität und Links

Diese Reihenfolge verändert die Ergebnisse. Wenn Seiten blockiert sind, falsche Canonicals haben oder intern schlecht verlinkt sind, lösen überarbeitete Meta Descriptions das eigentliche Problem nicht.

Was der skill in der Praxis prüfen sollte

Aus den Signalen im Repository und den Erwartungen der Evals ergibt sich, dass gute seo-audit usage unter anderem Prüfungen wie diese enthalten sollte:

• robots.txt
• Vorhandensein und Qualität der XML-Sitemap
• Signale zu Indexierung und Crawling
• Website-Architektur und interne Verlinkungslogik
• Title Tags und Meta Descriptions
• Heading-Struktur
• Content-Relevanz und -Optimierung
• wahrscheinliche technische Probleme, die Auffindbarkeit oder Performance beeinträchtigen

Die Findings sollten anschließend in einem entscheidungsfähigen Report organisiert werden, nicht in einer flachen Liste von Beobachtungen.

Die Einschränkung bei der Schema-Erkennung beachten

Das ist ein echter Umsetzungsaspekt und keine Randnotiz. Der Skill warnt ausdrücklich davor, auf Basis einfacher Page-Fetch-Ergebnisse zu behaupten, es sei „kein Schema Markup vorhanden“. Viele Websites injizieren Schema clientseitig oder auf eine Weise, die ein einfacher Fetch nicht erfasst.

Eine gute Ausgabe sollte deshalb etwa Folgendes sagen:

• "Schema markup could not be reliably verified from current fetch-based inspection."
• "Validate with rendered HTML, source inspection, or a schema testing workflow before concluding it is missing."

Genau das macht den seo-audit skill vertrauenswürdiger als Audits, die ihre Sicherheit übertreiben.

Die erwartete Berichtsstruktur nutzen

Für eine praxistaugliche Übergabe sollte der Skill Folgendes liefern:

• Executive Summary
• Technical SEO Findings
• On-Page SEO Findings
• Content Findings
• Prioritized Action Plan

Das ist wichtig, weil Stakeholder selten auf rohe Notizen reagieren. Sie handeln auf Basis priorisierter Probleme mit Begründung, Wirkung und nächsten Schritten.

Mit den evals die Ausgabequalität beurteilen

skills/seo-audit/evals/evals.json ist eine der besten Dateien, wenn du entscheiden willst, ob du diesem Skill vertraust und ihn dauerhaft nutzen solltest. Sie zeigt die erwarteten Verhaltensweisen:

• Rückfragen stellen, wenn Kontext fehlt
• Crawlability vor Content-Politur priorisieren
• Grundlagen wie robots und Sitemap prüfen
• keine unbelegten Schema-Behauptungen aufstellen
• Findings in einer nutzbaren Struktur präsentieren

Wenn dein Agent diese Dinge nicht tut, folgt er dem Skill in der Praxis nicht wirklich gut.

seo-audit skill FAQ

Ist dieser seo-audit skill für Einsteiger geeignet

Ja, besonders für Einsteiger, die eine sinnvolle Audit-Reihenfolge brauchen. Er hilft, zufälliges SEO-Abhaken zu vermeiden, und bietet einen klareren Startpunkt. Trotzdem müssen auch Einsteiger Business-Kontext liefern, denn der Skill ersetzt nicht das Verständnis dafür, welche Seiten und Suchanfragen wirklich relevant sind.

Worin unterscheidet sich das davon, eine KI direkt um ein SEO-Audit zu bitten

Ein normaler Prompt kann eine plausibel klingende Liste mit SEO-Tipps erzeugen. Dieser Skill ist besser, wenn du Folgendes willst:

• eine definierte Audit-Reihenfolge
• bessere Fragen zur Eingrenzung
• weniger unbelegte Behauptungen
• einen besser nutzbaren Abschlussbericht

Der größte praktische Vorteil sind nicht „mehr Features“, sondern weniger Rätselraten und eine bessere Priorisierung.

Kann ich seo-audit für SEO Content einsetzen

Ja, aber mit der richtigen Erwartung. Der Skill unterstützt seo-audit for SEO Content, indem er On-Page-Optimierung, Content-Qualität und wahrscheinliche Relevanzprobleme prüft. Er ist nicht primär ein Generator für Content-Briefs. Nutze ihn, um zuerst zu diagnostizieren, ob bestehende Seiten zu Search Intent, Metadaten, Headings und Website-Struktur passen, bevor du entscheidest, welche Inhalte überarbeitet oder neu erstellt werden sollten.

Braucht der skill Zugriff auf Search Console oder Analytics

Nein. Du kannst ihn auch nur mit einer öffentlichen Website-Prüfung verwenden. Die Qualitätsgrenze liegt dann aber niedriger. Ohne Search Console, Analytics oder Crawl-Exporte kann der Skill wahrscheinliche Probleme identifizieren, jedoch nicht jede Performance- oder Indexierungsbehauptung vollständig validieren.

Wann sollte ich diesen skill nicht verwenden

Überspringe diesen Skill, wenn dein Hauptbedarf ist:

• ausschließlich Schema Markup hinzuzufügen oder zu debuggen
• großflächig Seiten zur Keyword-Abdeckung zu generieren
• eine Strategie für AI Search Visibility statt einer klassischen SEO-Diagnose zu entwickeln

Er passt außerdem schlecht, wenn sofortige Umsetzung von Fixes gewünscht ist, ohne zuerst das zugrunde liegende Problem zu verstehen.

Ist die Schreibreferenz wirklich relevant

Ja, wenn die Audit-Ausgabe kundenseitig verwendet oder intern veröffentlicht wird. Die Referenz unter references/ai-writing-detection.md ist keine SEO-Framework-Datei, verbessert aber die Qualität der Auslieferung. Klarere, weniger offensichtlich maschinell geschriebene Empfehlungen werden von Teams tendenziell eher akzeptiert und umgesetzt.

So verbesserst du den seo-audit skill

Dem skill besseren Business-Kontext geben

Der schnellste Weg, den seo-audit skill zu verbessern, ist, ihn nicht wie einen generischen Scanner zu behandeln. Teile ihm mit:

• wer die Zielgruppe ist
• welche Seiten am wichtigsten sind
• welches Conversion-Event zählt
• was sich kürzlich geändert hat
• welche Suchanfragen dich interessieren

So wird aus „SEO-Beobachtungen“ echte „SEO-Entscheidungsgrundlage“.

Den Scope eingrenzen, wenn die Website groß ist

Bei großen Websites solltest du statt eines vagen Full Audits lieber eines davon anfordern:

• Homepage plus die 5 wichtigsten Umsatzseiten
• ein Verzeichnis oder Blog-Bereich
• ein Template-Typ
• ein Cluster mit Traffic-Verlust

Kleinere Scopes führen zu schärferen Findings und besser umsetzbaren Empfehlungen.

Nach Belegen und Unsicherheitskennzeichnung fragen

Um weichgespülte Ausgaben zu vermeiden, fordere:

• beobachtetes Problem
• warum es relevant ist
• Confidence Level
• empfohlene Maßnahme
• erwartete Wirkung
• was weiter validiert werden muss

Das ist besonders hilfreich bei technischen und Indexierungsbehauptungen, bei denen eine öffentliche Prüfung unvollständig sein kann.

Oberflächliche Empfehlungen verhindern

Häufiger Fehlmodus: Die erste Ausgabe fokussiert sich zu stark auf Titles, Keywords und generische Hinweise wie „improve content quality“.

Korrigiere das, indem du nach Folgendem fragst:

• zuerst Crawl- und Index-Blocker
• Muster auf Seiten-Template-Ebene statt nur Detailkritik an einzelnen Seiten
• interne Verlinkungspfade zu Prioritätsseiten
• Diskrepanzen zwischen Business-Intent und den tatsächlich rankenden Seitentypen

So bleibt der seo-audit auf Hebelwirkung fokussiert statt auf kosmetische Korrekturen.

Beispiele für starke und schwache Seiten mitgeben

Wenn du weißt, welche Seiten gut performen und welche nicht, teile beides. Der Skill kann dann vergleichen:

• Title-Format
• Heading-Tiefe
• Content-Struktur
• interne Links
• Intent-Match
• Conversion-Ausrichtung

Vergleichende Inputs führen oft zu besseren Empfehlungen, als die gesamte Domain kalt auditieren zu lassen.

Nach dem ersten Audit iterieren

Der erste Durchlauf sollte in der Regel eine priorisierte Liste liefern, nicht schon die endgültige Roadmap. Gute Follow-up-Prompts sind zum Beispiel:

• "Expand only the top 3 technical issues with validation steps."
• "Turn the content findings into page-specific rewrite priorities."
• "Separate quick wins from engineering-heavy fixes."
• "Map each recommendation to likely impact and effort."

Das ist der beste Weg, um seo-audit usage in einen belastbaren Umsetzungsplan zu überführen.

Auf überzogene Aussagen bei begrenztem Zugriff achten

Wenn der Agent nicht crawlen, JavaScript rendern oder Plattform-Einstellungen prüfen kann, sollte er nicht so formulieren, als hätte er vollständige Sicht. Der Skill weist bereits in die richtige Richtung. Diese Vorsicht sollte beibehalten werden. Sie erhöht das Vertrauen und reduziert False Positives.

Die Ausgabe als Triage-Ebene nutzen

Dieser seo-audit guide funktioniert am besten als diagnostische First-Pass-Triage vor vertiefter Spezialistenarbeit. Nutze ihn, um:

• wahrscheinliche Blocker zu identifizieren
• Untersuchungswege zu priorisieren
• Stakeholder-Zusammenfassungen vorzubereiten
• zu entscheiden, ob tieferes Technical SEO, Content-Arbeit oder Implementierungsunterstützung nötig ist

Das ist eine stärkere Rolle, als vom Skill allein zu erwarten, vollständige SEO-Tooling-Suiten oder Live-Zugriff auf die Website zu ersetzen.