Was macht GitHub-Repository-Optimierung?

Verwandle jedes GitHub-Repository in eine hochkonvertierende, SEO-optimierte Landingpage, die Stars, Follower und Traffic anz zieht. Jedes Repository, das du bearbeitest, sollte wie ein Top-100-Open-Source-Projekt aussehen.

Diese Fähigkeit hat zwei Modi:

Optimieren — README, Metadaten und Struktur eines Repos für maximale Conversion umschreiben
Beraten — dem Benutzer eine Star-Wachstumsstrategie mit der untenstehenden Wissensdatenbank geben

Ziele (in Prioritätsreihenfolge)

Stars — die primäre Social-Proof-Metrik auf GitHub
Follower — Traffic auf die sozialen Profile des Repository-Besitzers lenken
Auffindbarkeit — in der GitHub-Suche, Google und LLM-Antwortmaschinen ranken
Traffic — Besucher in Nutzer/Follower verwandeln
Professionelle Glaubwürdigkeit — Qualität durch Struktur und Poliertheit signalisieren

Schritt 0: Benutzerkonfiguration (selbstaktualisierend)

Vor der Optimierung musst du wissen, wem dieses Repository gehört. Dieser Schritt wird einmal ausgeführt – danach wird die Konfiguration wiederverwendet.

Nach vorhandener Konfiguration suchen

Suche nach ~/.claude/skills/github-optimization/.config.yml. Wenn sie existiert, lade die Werte und fahre mit Schritt 1 fort. Zeige dem Benutzer an, was geladen wurde, und frage, ob sich etwas geändert hat.

Wenn keine Konfiguration existiert, erkennen + fragen

Automatisch erkennen aus Git-Konfiguration und GitHub-API:
- gh api user — liefert den authentifizierten GitHub-Benutzernamen und das Profil-URL
- gh api repos/<owner>/<repo> — liefert den Repository-Besitzer (kann Organisation oder Benutzer sein)
- git config user.name — liefert den lokalen Git-Anzeigenamen
Den Benutzer fragen nach allem, was du nicht erkennen kannst:
- Anzeigename — ihr richtiger Name oder die bevorzugte Namensnennung (z. B. "Max Mustermann")
- X/Twitter-Handle — für das Follow-Abzeichen (z. B. "@maxmustermann"). Wenn sie es nicht wollen, überspringe es.
- Firma oder Organisation — für die Fußzeilennennung (optional)
- Firmen-URL — Link für den Firmennamen (optional)
- Website-URL — persönliche oder Firmenseite (optional)
Die Konfiguration speichern unter ~/.claude/skills/github-optimization/.config.yml:

# GitHub Optimization Skill — Benutzerkonfiguration
# Diese Datei wird automatisch generiert. Jederzeit bearbeitbar.
author_name: "Max Mustermann"
author_github: "maxmustermann"
x_handle: "maxmustermann"          # leer lassen "" um Follow-Abzeichen zu überspringen
company_name: "Acme GmbH"          # leer lassen "" um zu überspringen
company_url: "https://acme.com"
website_url: "https://maxmustermann.dev"

Diese Variablen verwenden während der gesamten Pipeline:
- {OWNER} — GitHub-Benutzername oder Organisation (aus Repository-URL, pro Repo erkannt)
- {REPO} — Repository-Name (pro Repo erkannt)
- {AUTHOR_NAME} — aus Konfiguration
- {AUTHOR_GITHUB} — aus Konfiguration
- {X_HANDLE} — aus Konfiguration (kann leer sein)
- {COMPANY_NAME} — aus Konfiguration (kann leer sein)
- {COMPANY_URL} — aus Konfiguration (kann leer sein)
- {WEBSITE_URL} — aus Konfiguration (kann leer sein)

Wenn ein Feld leer ist, lasse dieses Element vollständig aus der Ausgabe weg. Keine leeren Platzhalter oder defekten Abzeichen.

Konfiguration aktualisieren

Wenn der Benutzer "aktualisiere meine Konfiguration", "ändere mein X-Handle" oder ähnliches sagt, aktualisiere die Datei .config.yml und bestätige die Änderung.

Die Optimierungspipeline

0. KONFIG       -> Benutzerkonfiguration laden oder erstellen (einmalig, selbstaktualisierend)
1. AUDIT        -> Aktuelles README, Beschreibung, Themen, Repo-Struktur lesen
2. KEYWORDS     -> Zielsuchbegriffe für die Domäne dieses Repos identifizieren
3. METADATEN    -> Repo-Name, Beschreibung (About) und Themen optimieren
4. README       -> Als Landingpage nach der untenstehenden Vorlage umschreiben
5. HUMANISIEREN -> Den Text-Humanisierungs-Skill auf alle Prosa anwenden, um KI-Muster zu entfernen
6. EXTRAS       -> LICENSE, CONTRIBUTING.md hinzufügen, falls nicht vorhanden
7. VERÖFFENTLICHEN -> Commit, Push, anwenden von gh repo edit für Beschreibung/Themen

Skill-Verkettung

Diese Fähigkeit ruft während der Ausführung andere Fähigkeiten auf:

humanise-text — Nach dem Entwurf des READMEs den Skill humanise-text auf alle Prosaabschnitte anwenden. Dies entfernt KI-Schreibmuster und lässt den Text wie von einer echten Person geschrieben klingen. Nicht verhandelbar – jedes README muss durch diesen Schritt.

Schritt 1: Audit

Lese den aktuellen Zustand:

README.md Inhalt und Struktur
Repo-Beschreibung (About-Bereich)
Themen/Tags
Lizenz
Dateistruktur
Vorhandene Abzeichen

Notiere, was fehlt, was schwach ist, was gut ist.

Schritt 2: Keyword-Recherche

Identifiziere 3-5 Ziel-Keywords, nach denen Entwickler suchen würden, um dieses Projekt zu finden. Berücksichtige:

Welches Problem löst es?
Welche Technologie verwendet es?
In welcher Domäne befindet es sich?

Diese Keywords müssen vorkommen in: Repo-Name (wenn möglich), About-Beschreibung, README H1- und H2-Überschriften und Themen-Tags.

Schritt 3: Metadaten-Optimierung

About-Beschreibung

Idealerweise unter 120 Zeichen, maximal 250
Beginne mit dem, was es tut, nicht dem, was es ist
Enthält das primäre Keyword natürlich
Format: <Aktionsverb> <was> für <wen/was>. <Wichtiges Unterscheidungsmerkmal>.

Themen-Tags

Wähle 10-20 Tags aus drei Kategorien:

Zweck-Tags — was das Projekt tut
Technologie-Stapel-Tags — verwendete Technologien
Domänen-Tags — Bereich oder Branche

Anwenden mit:

gh repo edit {OWNER}/{REPO} --add-topic tag1 --add-topic tag2 ...

Schritt 4: README-Neuschreiben

Das README ist eine Landingpage, keine Dokumentation.

README-Vorlage

Passe Abzeichen basierend auf den verfügbaren Benutzerinformationen in der Konfiguration an:

<div align="center">

# <Projektname>

**<Einzeiler — was es in einfachem Deutsch tut>**

<br />

[![Star this repo](https://img.shields.io/github/stars/{OWNER}/{REPO}?style=for-the-badge&logo=github&label=%E2%AD%90%20Star%20this%20repo&color=yellow)](https://github.com/{OWNER}/{REPO}/stargazers)

Wenn {X_HANDLE} gesetzt ist, füge neben das Star-Abzeichen hinzu:

&nbsp;&nbsp;
[![Follow @{X_HANDLE}](https://img.shields.io/badge/Follow_%40{X_HANDLE}-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/{X_HANDLE})

Wenn {X_HANDLE} leer ist, lasse das Follow-Abzeichen vollständig weg.

Dann fortsetzen mit Glaubwürdigkeitsabzeichen:

<br />

[![<Abzeichen 1>](shields-url)](<link>)
&nbsp;
[![<Abzeichen 2>](shields-url)](<link>)

---

<Ein-Absatz-Pitch. Welchen Schmerz lindert dies? Warum sollte sich jemand darum kümmern?>

[Installation](#installation) | [Funktionsweise](#funktionsweise) | [Funktionen](#funktionen) | [Mitwirken](#mitwirken)

</div>

Abzeichen-Regeln

Reihe 1 (CTAs — groß, auffällig):

Star-Abzeichen mit Live-Zähler — IMMER zuerst, style=for-the-badge, gelb
Follow auf X-Abzeichen — NUR wenn {X_HANDLE} gesetzt ist

Reihe 2 (Glaubwürdigkeitsabzeichen — gleiche Größe):

Alle Abzeichen verwenden style=for-the-badge — niemals Größen mischen
Wähle 2-4 relevante: Lizenz, PRs willkommen, Sprache/Framework, Build-Status

Abschnittsreihenfolge

Warum es das gibt / Das Problem — 2-3 Sätze zum Schmerzpunkt
Vorher vs. Nachher (optional) — Vergleichstabelle
Installation / Schnellstart — unter 5 Schritten, ein Befehl ideal
Funktionsweise — visueller Arbeitsablauf (ASCII-Diagramm, Tabelle oder nummerierte Schritte)
Funktionen / Anwendungsfälle — Tabelle oder Aufzählung, überfliegbar
Was es enthält / Struktur — Dateibaum, falls relevant
Konfiguration / Optionen (optional)
Sicherheit (optional)
Mitwirken — kurz, einladend
Lizenz — eine Zeile
Fußzeile mit CTAs — Star + Follow-Abzeichen wiederholt

Fußzeilen-Vorlage

Dynamisch aus der Konfiguration erstellen:

---

<div align="center">

Namensnennungszeile — aus verfügbaren Konfigurationsfeldern erstellen:

Wenn Autor + Firma + Website: Erstellt von [NAME](GITHUB) bei [FIRMA](FIRMA_URL) | [WEBSITE](WEBSITE_URL)
Wenn Autor + Firma (keine Website): Erstellt von [NAME](GITHUB) bei [FIRMA](FIRMA_URL)
Wenn Autor + Website (keine Firma): Erstellt von [NAME](GITHUB) | [WEBSITE](WEBSITE_URL)
Wenn nur Autor: Erstellt von [NAME](GITHUB)
Wenn nichts: Erstellt mit dem github-optimization Skill

<br />

**Wenn dir das nützlich ist:**

[![Star this repo](star-badge-url)](stargazers-url)

Wenn {X_HANDLE} existiert, füge auch hier das Follow-Abzeichen hinzu.

</div>

Schreibregeln

Nicht verhandelbar. Diese definieren die Stimme.

TUN:

Schreibe wie ein Mensch, der es einem Freund erklärt. Kurze Sätze. Aktiv.
Leite jeden Abschnitt mit dem Wert ein, nicht dem Mechanismus.
Verwende "du" und "dein" — sprich den Leser direkt an.
Sei konkret statt abstrakt.
Halte Absätze auf maximal 2-3 Sätze.
Verwende Tabellen für Vergleiche.

NICHT TUN:

Verwende keinen KI-Sprech: "nutzen", "optimieren", "ermöglichen", "nahtlos", "robust", "zukunftsweisend", "revolutionieren", "die Kraft von ... nutzen", "deinen Workflow aufwerten", "beschleunigen"
Beginne Sätze nicht mit "Dieses Projekt..." oder "Dieses Tool..."
Schreibe keine Textwüsten.
Verwende kein Passiv.
Füge keine Füllwörter hinzu: "im Grunde", "im Wesentlichen", "einfach", "nur"
Verwende keine Ausrufezeichen.

SEO in Überschriften:

H1 muss das primäre Keyword enthalten.
H2s sollten sekundäre Keywords natürlich enthalten.
Schreibe zuerst für Menschen, aber sei bewusst bei der Platzierung.

Schritt 5: Extras

Hinzufügen, falls nicht vorhanden:

LICENSE — MIT, sofern der Benutzer nichts anderes angibt
CONTRIBUTING.md — kurz, einladend, 3-Schritte-Prozess

Nicht hinzufügen, außer danach gefragt: CODE_OF_CONDUCT.md, SECURITY.md, .github/ISSUE_TEMPLATE/

Schritt 6: Veröffentlichen

Alle Änderungen mit einer beschreibenden Nachricht committen
An das Remote-Repository pushen
Repo-Metadaten über gh repo edit aktualisieren
Dem Benutzer melden: Was geändert wurde, die neue Beschreibung, hinzugefügte Themen, Live-URL

Checkliste vor Fertigstellung

Wissensdatenbank zum Star-Wachstum

Wenn Benutzer fragen "wie bekomme ich mehr Stars?", "Launch-Strategie", "mein Repo bewerben" oder ähnliches, verwende diese Wissensdatenbank, um sie zu beraten. Dieser Abschnitt ist Referenzmaterial, nicht Teil der Optimierungspipeline.

Kanal-Rankings (nach ROI)

Rang	Taktik	Aufwand	Erwartete Stars	Risiko
1	Gestaffelter Launch (HN + Reddit + X + PH am selben Tag)	Hoch (1 Tag Vorbereitung)	200-2.000+	Keines
2	Awesome-List-Einreichungen	Niedrig (PRs)	Langsamer Aufbau, verstärkt sich	Keines
3	README-Optimierung + Social Preview	Mittel (1 Stunde)	3-facher Multiplikator auf alle anderen Bemühungen	Keines
4	GitHub-SEO (Name, Themen, Beschreibung)	Niedrig (30 Min)	Passive langfristige Auffindbarkeit	Keines
5	Demo-GIF/Video im README	Mittel	Deutlich höhere Conversion	Keines
6	Eigene Awesome-Liste erstellen	Mittel	Langsamer Aufbau + Cross-Promotion	Keines
7	Newsletter-Einreichungen	Niedrig (E-Mails)	50-500 pro Feature	Keines
8	YouTube-Tutorials	Hoch	Bester nachhaltiger Langzeittreiber	Keines
9	Reziproker Listicle auf X	Niedrig	Netzwerkabhängig	Keines
10	Hacktoberfest-Tagging (Oktober)	Niedrig	50-200 saisonal	Spam-PRs
11	Discord/Community-Aufbau	Hoch, fortlaufend	Bindung/Befürwortung	Keines
12	Konferenzvorträge	Hoch	Niedrig direkt, hohe Verstärkung	Keines

Hacker News-Playbook

Beste Zeit: Dienstag-Donnerstag, 8-10 Uhr Pazifik. Sonntag, 18-21 Uhr Pazifik für geringere Konkurrenz.

Titelformat: Show HN: [Name] — [Was es konkret tut]

Was funktioniert: Schreibe wie ein Kollege, nicht wie ein Vermarkter. Keine Schlagwörter. Beginne mit dem Problem. Antworte auf jeden Kommentar in der ersten Stunde. Poste innerhalb von 5 Minuten einen eigenen substanziellen ersten Kommentar.

Schwellenwerte: 8-10 echte Upvotes + 2-3 durchdachte Kommentare in den ersten 30 Minuten, um unter die Top 10 zu kommen.

Account-Anforderungen: 250+ Karma mit technischem Kommentarverlauf für beste Ergebnisse. Frische Accounts werden moderiert.

Ring-Erkennung ist aggressiv. Tweet niemals "bitte upvote meinen HN-Post." Verwende private Kanäle (E-Mail, Slack, Discord), um Leute zu benachrichtigen.

Echte Ergebnisse:

Lago: #1 für 48+ Stunden, Haupttreiber auf 1.000 Stars
Encore: 1.500 Stars in einer Woche von einem einzigen Show HN
Durchschnitt: 121 Stars in 24 Stunden, 289 in einer Woche

Reddit-Playbook

Baue 2+ Wochen vor dem Posten Karma auf. Reddits 90/10-Regel: 90 % echte Aktivität, 10 % Eigenwerbung.

Subreddit	Hinweise
r/SideProject (453K)	Erlaubt explizit Eigenwerbung
r/programming (6M+)	Strenge Anti-Werbung, "wie wir X gebaut haben" funktioniert
r/selfhosted (500K+)	Konvertiert extrem gut
r/webdev	Nur "Showoff Saturday"
r/opensource	Linkfreundlich, geringeres Volumen
r/coolgithubprojects	Speziell für GitHub-Repos

Erwartet: 50-300 Stars pro erfolgreichem Post. Nachricht pro Subreddit anpassen.

Product Hunt-Playbook

Abstimmungsrücksetzungen: Täglich 00:01 Uhr Pazifik. Upvotes sind die ersten 4 Stunden versteckt.

Upvotes für #1: 600-800 an Wochentagen, 400-600 am Wochenende.

Beste Tage: Dienstag-Donnerstag.

Erwartet: 200-1.000 Stars von Top-5 Product of the Day. #1 kann 500-2.000+ liefern.

Zeitplan:

4-6 Wochen vorher: 200-500 E-Mail-Abonnenten aufbauen
1 Woche vorher: Alle Assets vorbereiten
Launch-Tag: Um 00:01 Uhr Pazifik live gehen, auf alles antworten, E-Mail-Blast um 6 Uhr Pazifik

Twitter/X-Playbook

Was funktioniert: Kurze Demo-Videos/GIFs übertreffen Text. Tweets von Unterstützern treiben mehr Stars als eigene Tweets. Wochentagmorgen US-Zeit (9-11 Uhr ET).

Erwartet: 7 % Anstieg beim Starren durch Twittern. Virale Video-Tweets können in 6 Stunden 1.600 Stars erreichen.

Die gestaffelte Launch-Strategie

Die Meta-Strategie, die jedes schnell wachsende Repository verwendet hat:

Zeitpunkt	Aktion	Erwartete Stars
Woche vorher	Bei Newslettern einreichen (TLDR, Console.dev, Changelog)	--
Launch-Tag Vormittag	HN "Show HN" posten (Di-Mi, 8-11 Uhr ET)	121 Ø, bis zu 1.500
Launch-Tag Nachmittag	Reddit posten (r/programming, r/selfhosted, Domain-Sub)	50-300
Launch-Tag	Demo-Video twittern + Unterstützer zum Teilen bringen	50-500+
Launch-Tag	Product Hunt-Launch (00:01 Uhr Pazifik)	200-1.000
Folgewoche	Auf Feedback antworten, Awesome-Listen einreichen (PRs), in Foren teilen	Laufender Aufbau

In Ihrer bevorzugten KI fragen

Vorschau

Dokumentation