content-refresher

Überblick über die content-refresher-Skill

Was content-refresher leistet

content-refresher ist eine SEO-Workflow-Skill zum Aktualisieren älterer Artikel, die an Aktualität, Rankings oder Traffic verloren haben. Sie ist für eine klar umrissene Aufgabe gebaut: Content Decay diagnostizieren, entscheiden, ob sich ein Refresh für eine Seite lohnt, und einen strukturierten Aktualisierungsplan erstellen – statt vager „mach das mal besser“-Edits.

Für wen sich diese Skill eignet

Am besten geeignet für:

• SEO-Texter:innen und Content-Strateg:innen, die ältere Blog-Bestände betreuen
• Agenturen, die bestehende Seiten zurück in die Rankings bringen wollen
• Website-Betreiber:innen, die merken „der Traffic sinkt“ und dafür einen wiederholbaren Refresh-Prozess brauchen
• Teams, die vor dem Umschreiben ein klareres Refresh-Briefing wollen

Weniger nützlich ist die Skill, wenn du einen komplett neuen Artikel von Grund auf erstellst oder zunächst technische SEO-Probleme analysieren musst.

Die eigentliche Aufgabe dahinter

Die meisten Nutzer:innen wollen nicht einfach nur umgeschriebenen Text. Sie wollen Antworten auf Fragen wie:

• verliert diese Seite wirklich an Relevanz, oder liegt das Problem woanders?
• was sollte zuerst aktualisiert werden?
• was kann unverändert bleiben?
• welche neuen Abschnitte, Statistiken und Freshness-Signale stellen die Performance am ehesten wieder her?

Die content-refresher-Skill ist besonders stark, wenn du genau diese Entscheidungsebene brauchst – nicht nur Textgenerierung.

Was content-refresher besonders macht

Der wichtigste Unterschied ist die Struktur. Die Skill enthält:

• Leitlinien zur Erkennung von Content Decay mit Schweregrad-Schwellen
• False-Positive-Checks, damit Saisonalität oder technische Probleme nicht fälschlich dem Content angelastet werden
• Vorlagen für Refresh-Planung
• ein ausgearbeitetes Beispiel, das die erwartete Ausgabeform zeigt

Dadurch ist sie nützlicher als ein generischer Prompt wie „aktualisiere diesen Artikel für SEO“, vor allem wenn mehrere Stakeholder einen belastbaren Plan brauchen.

Was du vor der Installation prüfen solltest

Lies zuerst:

• optimize/content-refresher/SKILL.md
• optimize/content-refresher/references/content-decay-signals.md
• optimize/content-refresher/references/refresh-example.md
• optimize/content-refresher/references/refresh-templates.md

Wenn diese Dateien dazu passen, wie dein Team rückläufige Inhalte bereits heute bewertet, ist die content-refresher-Skill sehr wahrscheinlich ein guter Fit.

So nutzt du die content-refresher-Skill

Installationskontext für content-refresher

Laut Repository ist die Skill kompatibel mit Claude Code, dem skills.sh marketplace, ClawHub und dem Vercel Labs Skills-Ökosystem. Systempakete werden nicht benötigt. Optionaler Netzwerk- oder MCP-Zugriff ist nur dann relevant, wenn du während der Analyse Live-Daten aus SEO-Tools einbeziehen willst.

Wenn deine Umgebung GitHub-Skills direkt unterstützt, installiere über den Repository-Pfad, der optimize/content-refresher enthält.

Starte mit den richtigen Repository-Dateien

Beginne nicht nur mit dem vollständigen Skill-Text. Nutze stattdessen diese Reihenfolge:

1. SKILL.md für Trigger-Bedingungen und Workflow
2. references/content-decay-signals.md für die Priorisierungslogik
3. references/refresh-example.md, um das erwartete Analyseformat zu sehen
4. references/refresh-templates.md, um Erkenntnisse in nutzbare Deliverables zu überführen

Dieser Leseweg reduziert Rätselraten und zeigt dir schnell, ob die Skill wirklich die Outputs liefert, die dein Team braucht.

Welche Eingaben content-refresher braucht

Die content-refresher-Skill funktioniert am besten, wenn du mehr lieferst als nur eine URL und „bitte aktualisieren“. Gute Inputs sind:

• Seiten-URL
• aktueller Titel und Veröffentlichungsdatum
• Datum der letzten Aktualisierung
• Ziel-Keyword oder Topic Cluster
• aktuelle Rankings oder Traffic-Trend
• bekannte Wettbewerber, die die Seite inzwischen überholt haben
• Artikeltext oder Abschnitts-Outline
• veraltete Statistiken, Produkte, Screenshots oder Links, die du bereits vermutest
• Geschäftsziel: Rankings zurückholen, Conversions verbessern, Snippets gewinnen oder GEO-Sichtbarkeit unterstützen

Ohne diesen Kontext kann die Skill zwar weiterhin einen Plan entwerfen, die Empfehlungen bleiben dann aber allgemeiner.

Aus einem groben Ziel einen brauchbaren Prompt machen

Schwacher Prompt:

• „Refresh this article for SEO.“

Stärkerer Prompt:

• „Use the content-refresher skill on this post: [URL]. Traffic is down 32% YoY and rankings dropped from positions 4-5 to 10-12 for [keyword]. Published in 2023, never updated. I need a refresh plan that identifies what to keep, what to update, what new sections to add, stale statistics to replace, and whether the title should change.”

Dieser Prompt gibt der Skill einen klaren Trigger, einen Schweregrad, ein Business-Ziel und ein gewünschtes Ausgabeformat.

Das beste Prompt-Muster für die Nutzung von content-refresher

Eine praxistaugliche Struktur ist:

1. das Decay-Signal benennen
2. den Seitenkontext liefern
3. das Ziel definieren
4. eine gestufte Ausgabe anfordern

Beispiel:

• „Apply content-refresher to this blog post. First, check whether the decline looks like true content decay versus seasonality or technical issues. Second, score refresh priority. Third, produce a refresh plan with section-level actions, updated title options, FAQ opportunities, source gaps, and a prioritized rewrite checklist.”

Das passt sehr eng zu den eingebauten Referenzen der Skill.

Empfohlener Workflow für echte Refresh-Projekte

Nutze die Skill in vier Durchläufen:

1. Diagnose: Decay bestätigen und False Positives ausschließen
2. Planung: Abschnitte identifizieren, die bleiben, ausgebaut, entfernt oder ergänzt werden sollen
3. Rewrite-Briefing: konkrete Anweisungen für die Redaktion erzeugen
4. Execution-Review: den überarbeiteten Entwurf mit dem Refresh-Plan abgleichen

Dieser Workflow ist besser, als sofort ein vollständiges Rewrite anzufordern, weil er unnötige Umschreibungen vermeidet und wertvolles Material erhält.

So nutzt du Performance-Signale mit content-refresher richtig

Eine der stärksten Komponenten von content-refresher für SEO Content ist das Framework für Decay-Signale. Die Referenzdatei arbeitet mit Schwellen für Traffic- und Ranking-Rückgänge sowie mit Dringlichkeitsstufen wie watch, warning, critical und emergency.

Nutze diese Schwellen als Entscheidungshilfe, nicht als absolute Wahrheit. Prüfe vor jedem Refresh:

• Saisonalität über Year-over-Year-Vergleiche
• bekannte Algorithmus-Updates
• Crawl-/Indexing-Probleme
• Änderungen im Analytics-Tracking
• Produkt- oder Marktveränderungen, die die Search Intent verschoben haben

Wenn du diesen Schritt überspringst, aktualisierst du womöglich die falsche Seite oder löst das falsche Problem.

Welche Outputs du erwarten solltest

Ein guter Output aus content-refresher sollte enthalten:

• eine kurze Einschätzung zu Content-Qualität oder Vertrauenswürdigkeit
• Belege dafür, dass die Seite tatsächlich veraltet ist
• priorisierte Refresh-Maßnahmen
• Empfehlungen zu Titel und Struktur
• Statistiken und Links, die aktualisiert werden sollten
• neue Abschnitte oder FAQ-Blöcke, die ergänzt werden sollten
• einen Rewrite-Umfang, der „beibehalten“ klar von „ersetzen“ trennt

Wenn der Output sofort in umgeschriebene Absätze springt, ohne die Refresh-Logik zu erklären, fordere zuerst den Plan an.

Wann du ein vollständiges Rewrite anfordern solltest

Bitte erst dann um das Rewrite, wenn der Refresh-Plan stimmig ist. Die beste Reihenfolge:

• erster Prompt: Diagnose + Refresh-Plan
• zweiter Prompt: Rewrite Abschnitt für Abschnitt auf Basis des freigegebenen Plans
• dritter Prompt: Metadaten, FAQ, interne Links und Onpage-Freshness-Updates

Diese gestufte Nutzung von content-refresher gibt dir sauberere redaktionelle Kontrolle als eine One-Shot-Generierung.

Praktische Tipps für bessere Outputs

• Füge die bestehenden Überschriften ein, damit das Modell Entscheidungen zu keep/update/remove markieren kann.
• Gib Traffic- oder Ranking-Deltas an, nicht nur „es ist gefallen“.
• Nenne die SERP-Wettbewerber, die dich ersetzt haben.
• Sag dem Modell, ob die Seite evergreen bleiben oder jahresspezifisch werden soll.
• Bitte um Source-Replacement-Placeholder, wenn keine Live-Web-Verifikation verfügbar ist.
• Fordere „minimal necessary changes“ an, wenn du Rankings zurückholen willst, ohne die Struktur unnötig stark umzubauen.

Fälle, in denen die Skill nicht passt, und typische Hürden bei der Einführung

Nutze content-refresher nicht als ersten Schritt, wenn:

• die Seite nie gerankt hat
• das Hauptproblem technische SEO ist
• sich die Search Intent komplett verändert hat und die Seite ersetzt statt aktualisiert werden muss
• du einen compliance-geprüften Publikationsworkflow mit automatisch validierten Zitaten brauchst

Die Skill ist ein starkes Framework für Planung, ersetzt aber weder Faktenprüfung noch redaktionelles Urteilsvermögen.

content-refresher-Skill FAQ

Ist content-refresher besser als ein normaler SEO-Prompt?

In der Regel ja, wenn dein Problem die sinkende Performance einer bestehenden Seite ist. Ein normaler Prompt kann Text umschreiben, aber die content-refresher-Skill liefert dir einen refresh-spezifischen Prozess: Decay erkennen, False Positives vermeiden, Änderungen priorisieren und das Update sauber strukturieren.

Ist content-refresher anfängerfreundlich?

Ja, mehr als viele andere SEO-Skills, weil die Referenzen Schwellenwerte, Beispiele und Templates zeigen. Einsteiger:innen sollten trotzdem grundlegende Seitenmetriken verstehen und einschätzen können, ob eine Quelle oder Statistik noch aktuell ist.

Kann ich content-refresher ohne SEO-Tools nutzen?

Ja. Du kannst Traffic-, Ranking- oder qualitative Rückgangssignale auch manuell bereitstellen. Das Ergebnis wird besser, wenn du Daten aus Search Console, Analytics oder Third-Party-Rank-Tools einbringst, aber die Skill braucht sie nicht zwingend, um zu funktionieren.

Ist content-refresher nur für Blogposts geeignet?

Nein, aber Blog- und evergreen Editorial-Seiten sind der klarste Anwendungsfall. Die Skill kann auch bei Guides, Listicles, Vergleichsseiten und informativen Landingpages helfen. Weniger natürlich ist sie für Produktseiten oder stark programmatisch erzeugte Inhalte.

Was macht content-refresher für SEO Content nützlich?

Der Wert liegt nicht einfach in „alten Text aktualisieren“. Die Skill hilft bei der Entscheidung:

• ob die Seite überhaupt zu retten ist
• welche Freshness-Signale wirklich relevant sind
• wie viel von der ursprünglichen Struktur erhalten bleiben sollte
• wo neue Abschnitte, FAQs und aktualisierte Belege die Relevanz steigern können

Das ist besonders nützlich für Content-Teams, die viele alternde URLs verwalten.

Wann sollte ich content-refresher nicht verwenden?

Überspringe die Skill, wenn die Seite technische Indexierungsprobleme, Cannibalization-Probleme oder einen vollständigen Intent-Mismatch mit den aktuellen SERPs hat. In solchen Fällen solltest du zuerst Architektur oder Seitenausrichtung korrigieren, bevor du einen Refresh-Workflow startest.

Erzeugt die Skill finalen, direkt veröffentlichungsreifen Text?

Sie kann dabei unterstützen, aber ihr größter Wert liegt weiter vorn im Prozess: Analyse, Planung und Rewrite-Guidance. Betrachte sie zuerst als Entscheidungs- und Briefing-Tool.

So verbesserst du die content-refresher-Skill

Gib content-refresher bessere Belege

Das größte Output-Upgrade kommt durch bessere Inputs. Füge hinzu:

• alten und aktuellen Titel
• Veröffentlichungshistorie
• Zeitfenster für Ranking- und Traffic-Veränderungen
• betroffene Top-Queries
• Wettbewerber-Seiten, die aktuell gewinnen
• veraltete Aussagen, Screenshots, Beispiele oder Preisdaten
• interne Links, die auf die Seite verweisen

So kann die Skill einen umsetzbaren Refresh-Plan erstellen statt nur allgemeine Hinweise zu geben.

Frage nach Entscheidungen auf Abschnittsebene

Ein häufiger Fehler ist, nur generische Empfehlungen wie „mehr Tiefe hinzufügen“ zu bekommen. Verhindere das, indem du konkret fragst:

• „For each current H2, label keep, update, merge, remove, or replace.”
• „List exact new sections to add and why.”
• „Flag outdated year references, stats, products, and broken links.”

So wird content-refresher zu einem Werkzeug für Editorial Operations statt nur zu einem Ideengeber.

Trenne Diagnose und Umschreiben

Wenn du alles auf einmal anforderst, schreibt das Modell möglicherweise zu stark um, bevor überhaupt belegt ist, dass ein Refresh sinnvoll ist. Die Ergebnisse werden meist besser, wenn du content-refresher in Stufen nutzt:

1. Decay validieren
2. Refresh-Plan erstellen
3. Rewrite
4. QA gegen den Plan

Diese Reihenfolge erhöht in der Regel die Verlässlichkeit und reduziert unnötige Bearbeitung.

Dränge auf quellenbewusste Aktualisierungen

Ein weiterer typischer Fehler ist künstliche Frische: Formulierungen werden geändert, aber die Belege bleiben veraltet. Bitte die Skill darum, Folgendes zu liefern:

• eine Liste von Statistiken, die ersetzt werden müssen
• Citation-Placeholder für aktuelle Quellen
• Aussagen, die einen Faktencheck brauchen
• Beispiele, die gegen aktuellere ausgetauscht werden sollten

Für SEO Content helfen Freshness-Signale nur dann, wenn auch die zugrunde liegenden Informationen tatsächlich aktuell sind.

Grenze das Rewrite auf deine Absicht ein

Sag der Skill klar, ob du Folgendes willst:

• konservativen Refresh zur Ranking-Erholung
• größere Erweiterung, um gegen stärkere SERPs zu bestehen
• GEO-orientierte FAQ-Ergänzungen
• conversion-orientierte Updates bei gleichbleibender Search Intent

Ohne diese Vorgabe driftet der Output leicht in ein größeres Rewrite ab, als du eigentlich brauchst.

Nutze die bereitgestellten Referenzen als wiederverwendbare Templates

Der stärkste Hebel, um die Nutzung von content-refresher zu verbessern, ist die Referenzdateien als Arbeitsformat zu übernehmen:

• Decay-Schwellen aus references/content-decay-signals.md
• Ausgabeform aus references/refresh-example.md
• Abschnittsplanung aus references/refresh-templates.md

Das beschleunigt Team-Reviews, weil alle mit derselben Refresh-Logik arbeiten.

Achte auf diese typischen Fehlermuster

• saisonale Rückgänge als Content Decay behandeln
• Text aktualisieren, aber veraltete Zahlen oder Links stehen lassen
• Abschnitte hinzufügen, die die ursprüngliche Search Intent verwässern
• Titel zu aggressiv ändern, ohne URL-/Themenkontinuität zu berücksichtigen
• Seiten aktualisieren, die eigentlich konsolidiert oder ersetzt werden sollten

Die meisten schlechten Ergebnisse entstehen durch Fehldiagnosen, nicht durch schwaches Writing.

Iteriere nach dem ersten Output

Stelle nach dem ersten Plan Anschlussfragen wie:

• „Which 3 changes are highest ROI if I can only edit for one hour?”
• „What should I update without changing the URL?”
• „Which additions are most likely to improve snippet capture?”
• „What evidence gaps would block publication?”

Solche Rückfragen machen die content-refresher-Skill deutlich praxisnäher für echte Deadlines.

Woran du erkennst, ob der Refresh-Plan gut ist

Ein starker Plan ist so konkret, dass eine Autorin oder ein Autor ihn ohne Rätselraten umsetzen kann. Er sollte klar benennen:

• warum die Seite verloren hat
• ob ein Refresh überhaupt die richtige Maßnahme ist
• was unverändert bleibt
• was jetzt zwingend aktualisiert werden muss
• wie die überarbeitete Struktur besser zu den aktuellen SERPs passt

Wenn diese Antworten fehlen, solltest du vor dem Drafting noch einen weiteren Durchlauf machen.