SEO Fix
Setzt SEO-Befunde im Code um – und trennt strikt zwischen mechanischem Fix und inhaltlicher Entscheidung.
Das Problem
Ein großer Teil der SEO-Arbeit ist mechanisch, ein anderer eine inhaltliche Entscheidung. Wer die Grenze verwischt, produziert 200 automatisch generierte Titles, die alle plausibel klingen und keiner die Seite trifft.
Installation
Der Skill ist eine SKILL.md mit Referenztexten und abhängigkeitsfreien Node-Scripts – nichts davon ist an einen Anbieter gebunden. Wähle deinen Agenten:
Schritt 1
git clone https://github.com/larsdecker/agents-skillsSchritt 2
node agents-skills/install.mjs --agent cursor --skill seo-fix --target .Statt cursor auch copilot, windsurf, cline, gemini oder agents (für Codex, Zed, Amp, opencode). Sinnvoll zusammen mit --skill seo-check.
Getestet mit: Claude Code, Cursor, GitHub Copilot, Codex, Windsurf, Cline, Gemini CLI, Zed. Ein hier nicht genannter Agent funktioniert ebenfalls – Skill-Verzeichnis ablegen und in der Anweisungsdatei des Agenten darauf verweisen.
Was dabei herauskommt
- Änderungen im Code, framework-gerecht und an vorhandene Muster angepasst
- Gegenprobe nach jedem Durchgang statt Erfolgsbehauptung
- Liste dessen, was zusätzlich nötig ist, damit ein Fix wirkt
Was er nicht tut
- Kein Entfernen von noindex ohne Rückfrage
- Kein Markup für Inhalte, die auf der Seite nicht sichtbar sind
- Keine erfundenen Titles, Descriptions, Bewertungen oder alt-Texte
- Keine Änderung produktiver Weiterleitungen ohne Freigabe
Die Grenze, die den Skill brauchbar macht
Ein Canonical setzen, width und height ergänzen, fehlerhaftes JSON-LD korrigieren: mechanisch, risikofrei, sofort machbar.
Was ist das Hauptthema dieser Seite? Welcher Begriff gehört in den Title? Ist dieses noindex gewollt? Das sind inhaltliche Entscheidungen.
Den mechanischen Teil erledigt der Skill. Den inhaltlichen Teil bereitet er vor und legt ihn zur Entscheidung vor.
Wer diese Grenze verwischt, produziert Schaden, der schwer zu finden ist: hunderte generierte Titles, die einzeln plausibel klingen und in Summe keine Seite treffen. Google schreibt solche Titles um — und dann war die gesamte Arbeit wirkungslos, ohne dass es jemand merkt.
Die harten Grenzen
Diese Punkte gelten ausnahmslos, auch auf ausdrückliche Nachfrage:
Kein noindex entfernen ohne Rückfrage. Es ist oft gewollt. Im Zweifel legt eine solche Änderung eine Seite offen, die nicht öffentlich sein soll.
Kein Markup für nicht sichtbare Inhalte. Strukturierte Daten für Inhalte, die auf der Seite nicht stehen, sind ein Richtlinienverstoß und können eine manuelle Maßnahme auslösen. Dasselbe gilt für Sterne-Bewertungen ohne echte, sichtbare Rezensionen. Wird danach gefragt, erklärt der Skill das Risiko und schlägt vor, den Inhalt sichtbar zu ergänzen.
Kein dateModified aus dem Deployment-Zeitpunkt. Google steuert damit die Neu-Crawl-Frequenz. Ein Datum, das bei jedem Deployment ohne inhaltliche Änderung hochgesetzt wird, entwertet das Signal still — niemand merkt es, und die Wirkung ist weg.
Keine alt-Texte für Bilder, die der Agent nicht gesehen hat. Wenn Dateiname, Bildunterschrift und Kontext den Inhalt nicht hergeben, wird die Stelle markiert statt geraten. Ein falscher alt-Text ist für Screenreader-Nutzer schlechter als keiner — und der Fehler ist von außen nicht erkennbar.
Keine Änderung produktiver Weiterleitungen ohne Freigabe. Eine falsche Regel nimmt eine Site vom Netz.
Erst den Ort der Wahrheit finden
Der häufigste Grund, warum ein SEO-Fix „nichts gebracht hat", ist nicht der Fix selbst: Der Title wurde an einer von drei möglichen Stellen gesetzt, und eine andere überschreibt ihn. Beide Stellen sehen für sich korrekt aus, und im Code ist der Konflikt kaum zu sehen.
Deshalb beginnt der Skill immer damit, zu klären, wo Metadaten in diesem Projekt herkommen — und erweitert den vorhandenen Weg, statt einen zweiten einzuführen. Ein zusätzliches SEO-Paket zu installieren, wo das Framework eine eigene API hat, erzeugt genau diese zweite Quelle.
references/framework-patterns.md enthält die Muster für Next.js (App und Pages Router), Nuxt 3, Astro, SvelteKit, Vue, statisches HTML, WordPress, Server-Header für Nicht-HTML-Dateien und Edge-Umgebungen — jeweils mit den Fallen, die dort typisch sind.
Nach Wirkung, nicht nach Aufwand
Fünf Stufen, jede Voraussetzung für die nächste: Indexierbarkeit, Crawler-Sichtbarkeit, Verständnis, Verlinkung, Feinschliff. Jeder Eintrag in references/fix-priority.md ist zusätzlich als mechanisch oder Entscheidung markiert — das ist die Information, die bestimmt, ob der Agent selbst handeln darf.
Zwei Einordnungen, die von der üblichen Praxis abweichen:
Ein defektes og:image steht in Stufe 1, obwohl es kein Rankingfaktor ist. Wenn alle Seiten dasselbe Bild referenzieren und dieses nicht ausgeliefert wird, ist jede geteilte Vorschau der gesamten Site defekt. Ein einzelner Fix mit maximaler Reichweite gehört nach vorne.
URLs bestehender Seiten werden nicht ohne Not geändert. Jede Änderung braucht eine 301, entwertet externe Links leicht und kostet vorübergehend Sichtbarkeit. Ein Unterstrich im Slug ist kein hinreichender Grund. Bei Neuanlagen richtig machen — bestehende nur bei konkretem Anlass.
Was nach dem Fix noch fehlt
Der am häufigsten übersehene Teil, und der häufigste Grund für „die Korrektur hat nichts gebracht":
- Social-Plattformen cachen Vorschauen tage- bis wochenlang. Nach einem
og:image-Fix muss der Cache aktiv erneuert werden, sonst bleibt die alte, defekte Vorschau sichtbar. - Eine neue Sitemap muss eingereicht werden.
- Nach einem
noindex-Ausbau dauert die Wiederaufnahme Tage bis Wochen. - Ein Fix im Code ist noch nicht live. Der Skill sagt das ausdrücklich, statt Fertigstellung zu suggerieren.
Und keine Erfolgsprognose. „Das behebt X" ist belegbar, „das verbessert das Ranking" nicht.
Zusammenspiel
SEO Check findet und bewertet, dieser Skill setzt um. Getrennt, weil Finden und Ändern unterschiedliche Vorsicht brauchen: Ein Audit darf jederzeit laufen, eine Änderung an produktiven Weiterleitungen nicht.
Für Auffindbarkeit in KI-Antwortmaschinen — llms.txt, Retrieval-Crawler, Zitierfähigkeit — ist GEO Audit zuständig. Dieser Skill fasst diese Bereiche bewusst nicht an, damit keine widersprüchlichen Änderungen entstehen.
