Communitygithub.com

zijieguo2003/blog-builder-skill

Anleitung zur schnellen Einrichtung eines persönlichen Blogs von Grund auf. Deckt Framework-Auswahl (Hugo, Hexo, Astro, Next.js), Theme-Konfiguration, Generierung von Blogbeitragsvorlagen mit Frontmatter, Deployment auf GitHub Pages / Vercel / Cloudflare Pages sowie vollständige SEO-Einrichtung (Sitemap, robots.txt, Open Graph, kanonische URLs) ab.

Was ist blog-builder-skill?

Dieses Skill dient als umfassender Leitfaden für Entwickler und technisch weniger versierte Nutzer, die schnell einen persönlichen Blog von Grund auf aufsetzen möchten. Es unterstützt die gängigsten Static-Site-Generatoren (Hugo, Astro, Hexo, Next.js) und begleitet den Nutzer durch den gesamten Workflow: von der Auswahl des passenden Frameworks über die Installation eines Start-Themes bis hin zur Erstellung von Beitragsvorlagen mit korrektem Frontmatter. Der Fokus liegt auf praktischen, sofort einsetzbaren Lösungen – anstatt nur Konzepte zu erklären, liefert das Skill konkrete Code-, YAML- und TOML-Beispiele sowie vorgefertigte GitHub Actions-Workflows für das Deployment auf GitHub Pages, Vercel oder Cloudflare Pages. Darüber hinaus wird eine vollständige SEO-Konfiguration bereitgestellt (Sitemap, robots.txt, Open Graph, kanonische URLs), wobei typische Fallstricke wie die BaseURL in Hugo oder das site-Feld in Astro explizit hervorgehoben werden. Das Skill eignet sich für alle, die ein neues Blog starten, ein bestehendes Blog migrieren oder einfach eine unkomplizierte, produktionsreife Lösung suchen – und zwar plattformübergreifend für Claude Code, Cursor, Codex und andere KI-Assistenten.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add zijieguo2003/blog-builder-skill

In Ihrer bevorzugten KI fragen

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

Dokumentation

Blog Builder

Helfen Sie dem Nutzer, einen persönlichen Blog zu starten – von der Framework-Auswahl bis zum Live-Deployment mit korrekter SEO. Vollständiger Umfang: Framework-Wahl -> Theme -> Beitragsvorlage -> Deployment -> SEO.

Workflow

Schritt 1 – Nutzerkontext verstehen

Fragen Sie (oder leiten Sie aus dem Kontext ab):

  • Technischer Hintergrund? (nicht-technisch / JS-Entwickler / Python-Entwickler / etc.)
  • Neustart oder bereits bestehende Website?
  • Bevorzugtes Deployment-Ziel: GitHub Pages, Vercel, Cloudflare Pages?
  • Inhaltlicher Fokus: Schreiben, Portfolio, Tutorial-Blog, Dokumentation?

Schritt 2 – Framework empfehlen

SituationEmpfohlen
Nicht-technisch, möchte nur schreibenHugo – kein JS, schnell, riesige Theme-Bibliothek
Schreibt bereits JS/TS, möchte Komponenten-KontrolleAstro – Insel-Architektur, hervorragende DX
Liebt Theme-Ökosysteme, fühlt sich mit Node wohlHexo – ausgereiftes Plugin-Ökosystem
React-Entwickler, möchte volle KontrolleNext.js – App Router + MDX

Präsentieren Sie die Empfehlung mit einer kurzen Begründung. Vor dem Fortfahren bestätigen lassen.

Schritt 3 – Framework einrichten

Lesen Sie die entsprechende Referenzdatei und führen Sie den Nutzer durch die Installation + ein Starter-Theme:

FrameworkReferenzdatei
Hugoreferences/hugo.md
Hexoreferences/hexo.md
Astroreferences/astro.md
Next.jsreferences/nextjs.md

Schritt 4 – Beitragsvorlage erstellen

Erstellen Sie eine sofort nutzbare Beitragsvorlagendatei mit vollständigem Frontmatter. Die Vorlagen unter assets/post-templates/ sind Ausgangspunkte – passen Sie sie an das gewählte Theme und die Präferenzen des Nutzers an.

Schritt 5 – Deployment

Lesen Sie references/deployment.md für den passenden CI/CD-Workflow. Stellen Sie das vollständige GitHub Actions-YAML bereit, bereit zum Einchecken.

Wichtige Hinweise:

  • GitHub Pages: Pushen nach .github/workflows/deploy.yml; Pages in den Repository-Einstellungen aktivieren
  • Vercel: Repository im Dashboard verbinden; Framework-Voreinstellung und Ausgabeverzeichnis festlegen
  • Cloudflare Pages: Build-Befehl = npm run build, Ausgabeverzeichnis = dist (Astro/Hexo/Next.js) oder public (Hugo)

Schritt 6 – SEO-Konfiguration

Jeder Blog braucht:

  1. sitemap.xml – framework-spezifisch; siehe references/.md
  2. robots.txt – tatsächlichen Dateiinhalt bereitstellen, nicht nur eine Beschreibung
  3. Open-Graph-Tags – og:title, og:description, og:image, og:url als tatsächliches Markup
  4. Kanonische URLs – baseURL/site in der Konfiguration setzen, damit Sitemaps und OG-Tags korrekt funktionieren

Immer darauf hinweisen: Die Site-URL muss in der Framework-Konfiguration gesetzt sein, damit die Sitemap korrekte absolute URLs generiert.

Leitprinzipien

  • Tatsächlichen Dateiinhalt (Code, YAML, TOML) bereitstellen, nicht nur Beschreibungen
  • Nur die relevanten Felder einfügen – überwältigendes Boilerplate vermeiden
  • Auf die ein oder zwei typischen Fallstricke hinweisen, die Anfänger verwirren (z. B. Hugo baseURL, Astro site-Feld)
  • Kopierfertige Beispiele bevorzugen

Verwandte Skills