Communitygithub.com

arunacharya1603/seo-engineering

Prüfen, planen, implementieren, testen und pflegen Sie nachhaltige SEO für Websites und Webanwendungen über Frameworks und Branchen hinweg.

Was ist seo-engineering?

Diese Skill-Beschreibung definiert eine umfassende und methodische SEO-Engineering-Disziplin für KI-Agenten (wie Claude Code, Cursor, Codex). Der Agent wird angeleitet, SEO-Aufgaben projektunabhängig, evidenzbasiert und mit minimalen, reversiblen Änderungen durchzuführen. Der Skill betont zehn unverhandelbare Prinzipien, darunter die Notwendigkeit eines Audits vor Änderungen, die Bevorzugung aktueller Suchmaschinendokumentation, das Verbot von Ranking-Garantien und Spam sowie die Trennung von Crawlbarkeit, Indexierbarkeit und Ranking. Der Workflow umfasst fünf Phasen: Projektverständnis, Ist-Analyse & Crawling, Priorisierung von Problemen, technische SEO (Crawling, Indexierung, Canonicalization, Sitemaps, robots.txt, JavaScript-Rendering, strukturierte Daten) und On-Page-SEO (Metadaten, Inhalte, interne Verlinkung, strukturierte Daten). Die Priorisierung erfolgt nach einem Schweregrad-Schema von P0 (Kritisch) bis P3 (Niedrig/Chance). Der Skill deckt alle gängigen Frameworks (Next.js, React, Angular, Vue, Laravel etc.), Hosting-Umgebungen und Suchmaschinen (Google, Bing) ab. Er wurde entwickelt, um nachhaltige organische Sichtbarkeit zu fördern und gleichzeitig Produktionsumgebungen zu schützen. Der Agent muss immer zuerst prüfen, die aktuellste Dokumentation verwenden und darf niemals Rankings versprechen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add arunacharya1603/seo-engineering

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

SEO-Engineering Skill

Mission

Helfen Sie dem Projekt, relevante, nachhaltige organische Sichtbarkeit und qualifizierte Besuche zu erzielen, indem Sie nützliche Seiten auffindbar, verständlich, für die Suche geeignet, vertrauenswürdig für Nutzer, technisch zuverlässig und mit Geschäftsergebnissen verbunden machen.

Dieser Skill ist projektunabhängig. Passen Sie ihn an das tatsächliche Unternehmen, die Zielgruppe, den Markt, das CMS/Framework, die Hosting-Umgebung, die Suchmaschinen und die Benutzeranfrage an. Gehen Sie nicht davon aus, dass das Projekt Next.js, ein Blog, E-Commerce, ein lokales Unternehmen oder eine bestimmte Domain ist, bis dies überprüft wurde.

Keine Technik garantiert Indexierung, Rich Results, KI-Zitationen, Traffic, Leads oder eine Ranking-Position. Suchmaschinen entscheiden, ob und wie sie Seiten crawlen, indexieren und ranken. Seien Sie genau darin, was getestet wurde versus was abgeleitet wurde.

Unverhandelbare Handlungsprinzipien

  1. Audit vor Bearbeitung. Überprüfen Sie das Repository und, wenn der Zugriff es erlaubt, die bereitgestellte Website. Identifizieren Sie, was bereits funktioniert. Bewahren Sie korrekte Konfigurationen und bestehendes SEO-Equity.
  2. Menschen zuerst, evidenzbasiert. Optimieren Sie für die Aufgabe des Besuchers und die Geschäftsrelevanz, nicht für Keyword-Dichte, willkürliches Inhaltsvolumen oder das Abhaken von Checklisten.
  3. Aktuelle Dokumentation gewinnt. Suchen Sie für Behauptungen, die von Änderungen der Suchfunktionen, Schema-Eignung, Spam-Richtlinien, APIs, Crawlern oder Tools betroffen sind, in der offiziellen, aktuellen Suchmaschinendokumentation. Bevorzugen Sie Google Search Central, Bing Webmaster-Dokumentation und offizielle Framework-/Plattform-Dokumentation. Community-Artikel können Hypothesen liefern, aber keine offizielle Anleitung überschreiben.
  4. Minimale, reversible Änderungen. Führen Sie die kleinste Implementierung durch, die ein verifiziertes Problem behebt. Refaktorieren Sie keinen unabhängigen Code, ändern Sie keine Domains/DNS/Nameserver, rotieren Sie keine Zugangsdaten, entfernen Sie keine Verifikationstoken, wechseln Sie kein Hosting oder stellen Sie ohne ausdrückliche Genehmigung in der Produktion bereit.
  5. Erfinden Sie niemals Beweise. Erfinden Sie keine Keyword-Volumina, Ranking-Schwierigkeiten, Backlinks, Traffic, Konkurrenten, Indexierungszustände, Leistungsmessungen, Autorenqualifikationen, Bewertungen, strukturierte Daten-Fakten oder erfolgreiche Testergebnisse.
  6. Keine Ranking-Garantien oder Spam. Empfehlen Sie kein Cloaking, versteckte Keyword-Texte, Keyword-Stuffing, Doorway-Pages, skalierte minderwertige Inhalte, Link-Schemata, gefälschte Bewertungen, irreführende Schema-Markups oder automatisierte Inhalte, deren Hauptzweck die Manipulation von Rankings ist.
  7. Trennung der Belange. Crawlbarkeit, Indexierbarkeit, Ranking, Darstellung in den Ergebnissen und Konversion sind unterschiedlich. Beheben Sie die relevante Ebene, anstatt zu behaupten, dass eine einzige technische Änderung alle löst.
  8. Schützen Sie sensible Daten. Geben Sie keine Geheimnisse, API-Schlüssel, Kundeninformationen, Analyse-IDs oder privaten Seiten in Berichten, Commits, Logs oder generierten Beispielen preis.
  9. Respektieren Sie die bestehende Architektur. Lernen Sie den Stack, die Namenskonventionen, das Routing-Modell und den Bereitstellungsprozess, bevor Sie eine Implementierung wählen. Bevorzugen Sie etablierte Projektmuster gegenüber dem Einführen von Abhängigkeiten.
  10. Berichten Sie Unsicherheiten klar. Wenn externer Zugriff, Zugangsdaten, Netzwerkzugriff oder Produktionstests nicht verfügbar sind, sagen Sie, was ungeprüft bleibt, und stellen Sie sichere manuelle Checks bereit.

Workflow-Übersicht

Gehen Sie für umfangreiche SEO-Aufgaben in dieser Reihenfolge vor:

  1. Verstehen Sie die Website und das Geschäft.
  2. Ermitteln Sie die Ausgangsbasis und überprüfen Sie die Implementierung.
  3. Recherchieren Sie bei Bedarf die aktuellen Suchmaschinenanforderungen.
  4. Erstellen Sie eine priorisierte Diagnose und einen Lösungsvorschlag.
  5. Implementieren Sie nur die autorisierten, notwendigen Änderungen.
  6. Führen Sie relevante Tests durch und überprüfen Sie das tatsächliche gerenderte/bereitgestellte Verhalten.
  7. Berichten Sie über Änderungen, Belege, verbleibende Risiken und Überwachungsschritte.

Konzentrieren Sie sich bei einer gezielten Anfrage (z. B. Verbesserung eines einzelnen Title-Tags) nur auf die relevanten Teile dieses Workflows, prüfen Sie aber dennoch auf Nebenwirkungen und vermeiden Sie unbelegte Behauptungen.

1. Entdecken Sie das Projekt und seine Ziele

Überprüfen Sie das Repository und die Bereitstellungshinweise, bevor Sie Code vorschlagen. Identifizieren Sie soweit anwendbar:

  • Geschäfts-/Website-Zweck, Zielgruppe, Angebot, Monetarisierungsmodell, Hauptkonversionen und geografische/sprachliche Ziele.
  • Website-Typ: informativ, Content-Publisher, SaaS, Marktplatz, E-Commerce, lokales Unternehmen, Portfolio, Dokumentation, Forum, Verlag oder Hybrid.
  • Framework/CMS und Version, Router, Rendering-Strategie, Inhaltsquelle, Paketmanager, Build-/Lint-/Test-Befehle und vorhandene SEO-Bibliotheken.
  • Hosting/CDN/Edge-Setup, Domain-Varianten, Weiterleitungen, Umgebungskonfiguration und Staging vs. Produktion.
  • Routentypen: Startseite, Dienst-/Kategorieseiten, Detailseiten, Blog/Artikel, Autor, Suchergebnisse, Tags/Kategorien, Paginierung, gefilterte/Facetten-URLs, Produktvarianten, lokalisierte Routen und Fehlerseiten.
  • Vorhandene Analyse- und Such-Tools: Google Search Console, GA4 oder andere Analysesysteme, Bing Webmaster Tools, Log-Zugriff, Rank-Tracking, Crawl-Berichte, Conversion-Tracking und Consent-Management-Plattform.
  • Bestehende technische Entscheidungen: Canonical-Host, Sitemap-Strategie, Robots-Regeln, Weiterleitungen, strukturierte Daten, Hreflang, Indexierungsrichtlinie, Metadaten-Vorlagen und interne Verlinkung.

Fordern Sie keine Informationen an, die das Repository oder der bereitgestellte Kontext bereits beantwortet. Wenn eine kritische Tatsache nicht ermittelt werden kann, fahren Sie mit expliziten Annahmen fort oder stellen Sie eine präzise Frage, wenn die Entscheidung wirklich davon abhängt.

2. Basislinie ermitteln und die Website crawlen

Verwenden Sie verfügbare Tools, die für die Umgebung geeignet sind. Bevorzugen Sie einen repräsentativen Crawl und eine gezielte Code-Inspektion gegenüber Annahmen, die nur auf Dateinamen basieren.

Repository-Inspektion

Überprüfen Sie relevante Dateien und Quellpfade, einschließlich, aber nicht beschränkt auf:

  • Paket-/Konfigurationsdateien, Framework-Konfiguration, Hosting-/Deployment-Konfiguration, Middleware/Proxy und Weiterleitungsregeln.
  • Stamm- und verschachtelte Layouts, Routen-/Seitenmodule, Metadaten-Helfer, Inhalts-Schemas, CMS-Konfiguration, Vorlagen und gemeinsame Navigations-/Footer-Komponenten.
  • sitemap.xml oder Sitemap-Generierungscode, robots.txt, Canonical-Logik, Weiterleitungen und URL-Erstellungshelfer.
  • Generatoren für strukturierte Daten, Bild-/Video-Komponenten, Analyse-/Consent-Setup und 404/410-Behandlung.
  • Vorhandene Tests und CI-Prüfungen.

Geben Sie keine .env-Werte oder andere Geheimnisse preis. Überprüfen Sie, ob erforderliche Variablen vorhanden sind, ohne Werte auszugeben.

Live-Site-Inspektion, wo erlaubt

Testen Sie repräsentative URL-Klassen und überprüfen Sie Antworten und gerendertes HTML. Erfassen Sie:

  • Statuscode, Weiterleitungskette und endgültige URL.
  • Canonical-Tag, Titel, Meta-Beschreibung, Robots-Direktiven und Robots-Header.
  • Hauptinhalt im rohen HTML und gerenderten HTML, wenn JavaScript involviert ist.
  • Interne Links, Sitemap-Aufnahme, strukturierte Daten und offensichtliche Duplikat-Versionen.
  • Mobile Darstellung, offensichtliche Rendering-Fehler und verfügbare Leistungsdaten.

Testen Sie mindestens die Startseite, wichtige Konversions-/Service-Seiten, große Auflistungsseiten, repräsentative Detailseiten, einen Blogbeitrag, eine Kategorie-/Tag-/Filter-Seite (falls zutreffend), eine gültige Query-String-URL und eine nicht existierende URL. Erstellen Sie für große Websites eine Crawl-Stichprobe und segmentieren Sie nach Vorlage. Behaupten Sie nicht, jede URL gecrawlt zu haben, wenn Sie das nicht getan haben.

Ausgangsbasis-Beweise

Zeichnen Sie verfügbare Ausgangsdaten vor Änderungen auf: URL-Anzahl nach Vorlage, Antwortstatus-Verteilung, Indexierbarkeit, Canonical-Konsistenz, Sitemap-Fehler, organische Klicks/Impressionen/CTR/Position, Konversionen, Core Web Vitals und relevante Geschäftsergebnisse. Erfinden Sie keine fehlenden Messungen.

3. Probleme rational priorisieren

Verwenden Sie Schweregrad und Vertrauen anstelle eines vagen SEO-Scores. Eine praktische Prioritätsskala:

  • P0 — Kritisch: Siteweites noindex, versehentlicher Robots-Block, falscher Canonical über Hauptrouten, Weiterleitungsschleife, Produktionsausfall, weit verbreitete 5xx, verlorene Domain/URL-Migration, Sicherheitskompromittierung oder ein anderes Problem, das verhindert, dass wichtige Seiten zugänglich/indexierbar sind.
  • P1 — Hoch: Wichtige Geld-/Inhaltsseiten sind blockiert, falsch kanonisiert, aus der Navigation/Sitemap ausgeschlossen, rendern keinen wesentlichen Inhalt, geben falsche Status zurück oder haben einen systemischen Vorlagenfehler.
  • P2 — Mittel: Wichtige Probleme mit Metadaten/strukturierten Daten/interner Verlinkung/Leistung, verwaiste Abschnitte, doppelte Seiten, schlechte Inhaltsabdeckung oder erhebliche Konversionshindernisse.
  • P3 — Niedrig/Chance: Kleinere Texterweiterungen, geringfügige Optimierung, optionale strukturierte Daten, isolierte Alt-Text-Lücken oder spekulative Inhaltsmöglichkeiten.

Geben Sie für jeden Befund an: Beweise, betroffene URLs/Vorlagen, wahrscheinliche Auswirkungen auf Nutzer/Suche, Vertrauen, Implementierungsaufwand, Risiko, Empfehlung und Validierungsmethode. Setzen Sie den Schweregrad nicht mit einer garantierten Ranking-Änderung gleich.

4. Technisches SEO: Crawling, Indexierung, URLs und Statuscodes

Crawlbarkeit und Indexierbarkeit

  • Trennen Sie Crawl-Zugriff (robots.txt, Serverantworten, erreichbare Links), Indexierungsanweisungen (noindex, Canonical-Signale, Status), Canonical-Auswahl und Ranking.
  • Stellen Sie sicher, dass wichtige öffentliche Inhalte über normale crawlbare Links erreichbar sind und erfolgreich antworten.
  • Verwenden Sie noindex nur absichtlich. Denken Sie daran, dass robots.txt das Crawlen blockiert; es ist keine zuverlässige Methode, eine URL aus den Suchergebnissen zu entfernen, und ein Crawler muss eine Seite normalerweise abrufen, um ihre seitenbezogene noindex-Direktive zu sehen.
  • Erlauben Sie keine Ressourcen, die zum Rendern oder Verstehen wichtiger Inhalte erforderlich sind, es sei denn, der Block ist beabsichtigt und validiert.
  • Halten Sie Login-, Konto-, Admin-, Checkout-, interne Such-, Vorschau-, Staging- und private Bereiche, wo angebracht, aus der Suche heraus. Schützen Sie private Inhalte mit Autorisierung; robots.txt ist keine Zugangskontrolle.
  • Stellen Sie sicher, dass fehlende Seiten einen echten 404 oder 410 zurückgeben, wo angebracht, anstatt einen 200 Soft 404. Leiten Sie nicht zusammenhängende gelöschte URLs nicht auf die Startseite weiter.
  • Erzwingen Sie keine Indexierung jeder URL. Einige Filter, interne Suchergebnisse, dünne Tag-Seiten, Duplikatvarianten und Dienstprogrammseiten verdienen möglicherweise keine Indexierung.
  • Behandeln Sie die Optimierung des Crawl-Budgets als spezialisiertes Anliegen für sehr große oder häufig aktualisierte Websites, nicht als Ritual für kleine Websites.

Canonicalisierung und URL-Normalisierung

  • Wählen Sie ein bevorzugtes Protokoll/Host/Pfad-Format, das der tatsächlichen Geschäftsentscheidung, Domain-Konfiguration und dem bestehenden SEO-Equity entspricht. Gehen Sie nicht davon aus, dass www oder non-www von Natur aus überlegen ist.
  • Richten Sie für echte Duplikat-URLs, wo angebracht, permanente Weiterleitungen, Canonical-Link-Elemente, interne Links, Sitemap-URLs und URLs für strukturierte Daten aus.
  • Verwenden Sie einen korrekten absoluten Canonical für jede indexierbare Seite. Vermeiden Sie es, nicht zusammenhängende Inhalte oder alle Seiten auf die Startseite zu kanonisieren.
  • Behandeln Sie Weiterleitungen als starke Canonicalisierungssignale, rel="canonical" als starkes Signal und die Sitemap-Aufnahme als schwächeres Signal. Dies sind Signale, keine absoluten Befehle.
  • Halten Sie Canonical-Ziele indexierbar, crawlbar, erfolgreich und relevant. Vermeiden Sie Weiterleitungsketten und -schleifen; verwenden Sie direkte Weiterleitungen zum endgültigen Ziel.
  • Entfernen Sie legitime Query-Parameter nicht blind. Verstehen Sie Kampagnen-Tracking, Filter, Paginierung, Sortierung, Produktvarianten und Anwendungsfunktionalität, bevor Sie URLs normalisieren.
  • Bewahren Sie bestehende wertvolle URLs, es sei denn, es gibt einen klaren Grund, sie zu ändern.

Weiterleitungen und Fehler

  • Verwenden Sie permanente Weiterleitungen (301 oder 308), wenn eine URL dauerhaft verschoben wurde und die Plattform sie korrekt unterstützt; verwenden Sie temporäre Weiterleitungen für temporäre Bedingungen.
  • Testen Sie HTTP/HTTPS, www/non-www und Trailing-Slash-Verhalten nur gemäß der beabsichtigten Site-Architektur.
  • Bewahren Sie den Pfad und sinnvolle Query-Parameter während der Hostname- oder Protokollnormalisierung.
  • Vermeiden Sie breite Regeln, die API-Endpunkte, Assets, Subdomains oder nicht zusammenhängende Pfade abfangen.
  • Erstellen Sie für URL-Änderungen eine Eins-zu-eins-Zuordnung von alt zu neu, wo immer ein echtes Äquivalent existiert. Leiten Sie veraltete URLs zum nächstgelegenen relevanten Ersatz weiter, nicht wahllos zur Startseite.
  • Überprüfen Sie Statuscodes und Weiterleitungshops in der bereitgestellten Umgebung; die lokale Konfiguration allein beweist kein Produktionsverhalten.

JavaScript und Rendering

  • Bestätigen Sie, dass primäre Inhalte, Seitentitel, Metadaten, Canonical-Hinweise, Links und strukturierte Daten in der crawlbaren/gerenderten Ausgabe vorhanden sind.
  • Verwenden Sie Server-seitiges Rendering, statische Generierung oder Pre-Rendering, wenn es für den Stack und die Website angemessen ist, migrieren Sie jedoch keine Frameworks allein wegen SEO-Folklore.
  • Machen Sie wichtige Navigation mit normalen <a href="...">-Links crawlbar. Verlassen Sie sich nicht nur auf Click-Handler oder unzugängliche App-Shell-Interaktionen für die Entdeckung.
  • Verlassen Sie sich nicht auf Benutzerinteraktion, Authentifizierung oder verzögerte Client-seitige Effekte, um wesentliche indexierbare Inhalte preiszugeben.
  • Vermeiden Sie widersprüchliche Canonical- oder Robots-Werte zwischen initialem HTML und JavaScript-gerendertem HTML. Wenn JavaScript Metadaten ändert, überprüfen Sie die gerenderte Ausgabe.
  • Verwenden Sie Framework-native Metadaten- und Routing-Systeme, anstatt Metadaten über widersprüchliche Mechanismen zu duplizieren.

Sitemap XML

  • Generieren Sie Sitemaps, wo möglich, aus der tatsächlichen Route/Inhaltsquelle.
  • Fügen Sie nur bevorzugte Canonical-URLs ein, die für die Indexierung in Frage kommen sollten; schließen Sie Weiterleitungen, noindex-URLs, Fehler, private Seiten und irrelevante URL-Varianten aus.
  • Verwenden Sie konsistent absolute URLs und den bevorzugten Host/Protokoll.
  • Aktualisieren Sie Sitemaps automatisch, wenn berechtigte Inhalte veröffentlicht, aktualisiert oder entfernt werden.
  • Verwenden Sie sinnvolle lastmod-Werte nur, wenn sie durch ein tatsächliches materielles Änderungsdatum unterstützt werden; aktualisieren Sie nicht jedes Datum bei jedem Deployment.
  • Respektieren Sie die Sitemap-Protokollgrenzen; verwenden Sie einen Sitemap-Index und segmentierte Sitemaps, wenn der Umfang oder die Wartbarkeit dies rechtfertigt. Mehrere Sitemaps verbessern nicht von Natur aus Rankings.
  • Validieren Sie XML-Syntax, Antwortstatus, Inhaltstyp, URL-Anzahl und Beispiel-URLs. Überprüfen Sie den Search Console Sitemaps-Bericht, wenn autorisiert.
  • Behaupten Sie nicht, dass die Sitemap-Einreichung Crawling, Indexierung oder Ranking garantiert.

robots.txt und Direktiven

  • Überprüfen Sie vorhandene Direktiven, bevor Sie sie bearbeiten. Bewahren Sie Regeln, es sei denn, sie sind falsch oder haben einen klaren dokumentierten Zweck.
  • Fügen Sie den Sitemap-Standort hinzu, wenn angemessen, und stellen Sie sicher, dass es die kanonische Sitemap-URL ist.
  • Unterscheiden Sie robots.txt-Crawl-Direktiven von meta robots- und X-Robots-Tag-Index-Direktiven.
  • Seien Sie besonders vorsichtig

…

[gekürzt für die Übersetzung]

Verwandte Skills