Communitygithub.com

Persönliche Website: SEO, damit man Sie beim Namen findet

Eine schlanke Claude-Code-SEO-Skill für statische Portfolios und persönliche Websites: 9-Punkte-Audit von Meta-Tags, Open Graph, Twitter Cards, JSON-LD, robots.txt, Sitemap, Bildern, Überschriften und Links, danach trägt sie jede Korrektur in Ihr HTML ein.

Was ist Persönliche Website: SEO, damit man Sie beim Namen findet?

Rezept Persönliche Website, Schritt 3 (gefunden werden), aus aevans-eng/seo-skill. Tippen Sie /seo oder fragen Sie einfach, warum Ihre Seite bei der Suche nach Ihrem Namen nicht erscheint. Der Agent liest Ihr HTML auf GitHub Pages, Netlify oder Vercel und führt ein 9-Punkte-Audit durch: Title, Description und Canonical; Open-Graph- und Twitter-Card-Tags; Person- und WebSite-JSON-LD auf der Startseite und CreativeWork auf Projektseiten; robots.txt und sitemap.xml; Alt-Texte, Lazy Loading und Bildgröße; ein H1 pro Seite, Überschriftenhierarchie und interne Links; HTTPS und defekte Links; sowie die Search-Console-Schritte nach dem Livegang. Es zeigt eine Bestanden/Nicht-bestanden-Tabelle und bietet an, alles zu ergänzen, wobei vorhandene Bilder für Share-Cards wiederverwendet werden. Keine Build-Tools, keine API-Aufrufe.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add aevans-eng/seo-skill

In Ihrer bevorzugten KI fragen

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

Dokumentation

SEO-Skill — Optimierung statischer Seiten

Leichtgewichtiges SEO-Audit- und Korrekturwerkzeug für statische HTML-Seiten (GitHub Pages, Netlify, Vercel usw.). Keine Build-Tools erforderlich. Liest Ihr HTML, meldet, was fehlt, und fügt es hinzu.

Einrichtung

Teilen Sie Claude vor der ersten Nutzung die folgenden Informationen zu Ihrer Seite mit, damit die richtigen Werte eingefügt werden können:

  • Domain (z.B. https://ihrename.de)
  • Seiten (z.B. index, about, resume, projects/foo)
  • Soziale Profile (LinkedIn, GitHub, Twitter usw.)
  • Suchbegriffe, für die Sie ranken möchten (z.B. "max mustermann softwareentwickler", "max mustermann portfolio")

Claude speichert diesen Kontext für die Sitzung. Sie müssen es nur einmal sagen.


Vorgehen bei Aufruf

Alle HTML-Dateien im Quellverzeichnis der Website einlesen. Jeden der folgenden Punkte prüfen. Eine Tabelle mit Bestehen/Nichtbestehen ausgeben und dann anbieten, die fehlenden Elemente zu korrigieren.


1. Wesentliche <head>-Elemente pro Seite

Jede HTML-Seite benötigt diese Elemente innerhalb von <head>:

<title>[Seitentitel] — [Ihr Name]</title>
<meta name="description" content="[einzigartig, 150-160 Zeichen, enthält Ziel-Keywords]">
<link rel="canonical" href="https://ihredomain.de/[pfad]/">

<!-- Open Graph -->
<meta property="og:title" content="[Gleicher Titel wie <title> oder kürzer]">
<meta property="og:description" content="[Gleiche Beschreibung wie meta description]">
<meta property="og:image" content="https://ihredomain.de/[pfad-zum-bild]">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:url" content="https://ihredomain.de/[pfad]/">
<meta property="og:type" content="website">
<meta property="og:site_name" content="[Ihr Name]">

<!-- Twitter Card -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="[Gleicher Titel wie og:title]">
<meta name="twitter:description" content="[Gleiche Beschreibung wie og:description]">
<meta name="twitter:image" content="https://ihredomain.de/[pfad-zum-bild]">

Richtlinien:

  • Titel: 50-60 Zeichen. Name + Alleinstellungsmerkmal.
  • Meta-Description: 150-160 Zeichen, einzigartig pro Seite, enthält Ihren Namen + relevante Keywords.
  • OG-Bild: 1200x630px empfohlen. Wenn kein benutzerdefiniertes Bild pro Seite vorhanden ist, ein gemeinsames verwenden. Ein echtes Bild von der Website verwenden, keinen Platzhalter.
  • Kanonische URL: muss exakt mit der tatsächlichen veröffentlichten URL übereinstimmen (konsistenter abschließender Schrägstrich).

2. Strukturierte Daten (JSON-LD)

Person + WebSite-Schema auf der Startseite hinzufügen:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "Person",
  "name": "[Ihr Name]",
  "url": "https://ihredomain.de",
  "jobTitle": "[Ihre Position/Rolle]",
  "affiliation": {
    "@type": "Organization",
    "name": "[Schule oder Firma]"
  },
  "sameAs": [
    "[GitHub-URL]",
    "[LinkedIn-URL]"
  ],
  "knowsAbout": ["[Fähigkeit1]", "[Fähigkeit2]", "[Fähigkeit3]"]
}
</script>
<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "WebSite",
  "name": "[Ihr Name] — [Portfolio-Untertitel]",
  "url": "https://ihredomain.de"
}
</script>

Für Projektseiten CreativeWork verwenden:

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "CreativeWork",
  "name": "[Projektname]",
  "author": { "@type": "Person", "name": "[Ihr Name]" },
  "description": "[Kurze Projektbeschreibung]",
  "url": "https://ihredomain.de/[projekt]/"
}
</script>

Regeln: Nur JSON-LD (nicht Microdata/RDFa). Kein FAQPage (nur für Regierungs-/Gesundheitsseiten). Kein HowTo (veraltet). Kein Platzhaltertext in Schemafeldern.

3. robots.txt

Im Stammverzeichnis der Seite erstellen:

User-agent: *
Allow: /

Sitemap: https://ihredomain.de/sitemap.xml

4. sitemap.xml

Im Stammverzeichnis der Seite erstellen:

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url>
    <loc>https://ihredomain.de/</loc>
    <lastmod>[JJJJ-MM-TT]</lastmod>
    <priority>1.0</priority>
  </url>
  <!-- für jede Seite wiederholen -->
</urlset>

lastmod auf die tatsächlichen letzten Änderungsdaten setzen. Sitemap aktualisieren, wenn sich Seiten ändern.

5. Bild-SEO

  • Alle <img>-Tags benötigen beschreibenden alt-Text (nicht "image1" oder "screenshot")
  • Nach Möglichkeit WebP verwenden, Bilder unter 200 KB halten
  • loading="lazy" bei Bildern unter dem Fold hinzufügen
  • OG-Bild sollte eine echte Datei sein, kein Platzhalter

6. Content- & Keyword-Signale

  • H1-Tags: Eines pro Seite, enthält Name oder Projektname + Keywords
  • Überschriftenhierarchie: h1 > h2 > h3, keine Ebenen überspringen
  • Name im Fließtext: Ihr Name sollte auf jeder Seite natürlich vorkommen
  • Interne Verlinkung: Seiten sollten aufeinander verlinken (Startseite zu Projekten, Über mich zu Projekten usw.)
  • Externe Links: Soziale Profile von Über mich/Startseite verlinkt

7. Technische Prüfungen

  • HTTPS: Sicherstellen, dass alle internen Links und Ressourcen https:// verwenden
  • Konsistenz des abschließenden Schrägstrichs: Ein Muster wählen und bei allen Links, Kanonischen URLs und der Sitemap beibehalten
  • Keine toten Links: Alle href- und src-Attribute auf Erreichbarkeit prüfen
  • Mobile Responsive: Viewport-Meta-Tag auf allen Seiten vorhanden
  • Seitengeschwindigkeit: Nicht-kritische Skripte verschieben. Minimales JS = gute Grundlage für statische Seiten.

8. Überprüfung nach der Veröffentlichung

Nach der Veröffentlichung:

  1. /robots.txt und /sitemap.xml direkt aufrufen, um die Erreichbarkeit zu prüfen
  2. OG-Tags testen, indem Sie einen Link auf Discord/Slack/Twitter teilen und die Vorschaukarte prüfen
  3. Sitemap in der Google Search Console einreichen
  4. Nach einigen Tagen site:ihredomain.de suchen, um die Indexierung zu prüfen
  5. Ihre Ziel-Keywords suchen und die Platzierung im Laufe der Zeit verfolgen

9. Google Search Console einrichten

  1. Gehen Sie zur Google Search Console und fügen Sie eine Property für Ihre Domain hinzu
  2. Verifizierung per DNS-TXT-Eintrag oder HTML-Datei-Methode durchführen
  3. Sitemap-URL einreichen
  4. Den Coverage-Bericht auf Indexierungsprobleme überwachen

Schnelle Audit-Ausgabe

Bei der Durchführung eines Audits alle HTML-Dateien lesen und folgende Tabelle ausgeben:

PrüfungStatusAnmerkungen
Meta-Descriptions......
OG-Tags......
JSON-LD-Schema......
robots.txt......
sitemap.xml......
Bild-Alternativtexte......
H1-Tags......
Interne Links......
Kanonische URLs......

Anschließend anbieten, die fehlenden Elemente zu korrigieren.

Verwandte Skills