Communitygithub.com

fkramer690/homepage

Schreibe oder aktualisiere einen Blogartikel für die FK Solution Design Homepage (EN und DE). Verwende dies immer dann, wenn ein Blogbeitrag, Artikel oder Fachbeitrag erstellt oder geändert wird.

Was ist homepage?

Dieses Skill befähigt einen KI-Agenten, vollständig zweisprachige Blogartikel (Englisch und Deutsch) für die FK Solution Design Homepage zu erstellen und zu überarbeiten. Es stellt sicher, dass alle Arbeiten gemäß der strikten Richtlinien in `docs/blog-guidelines.md` erfolgen, die Anforderungen an Inhalt, Ton und Vermeidung von KI-Textmüll („No AI slop“) definieren. Der Agent verwendet ausschließlich von Fabian bestätigte Fakten und Beispiele und erfindet keine Inhalte. Das Skill automatisiert den gesamten Workflow: Befüllen der Vorlage, Generieren des deutschen Artikels mit konsistentem Übersetzungsschlüssel, Erstellen einer technischen Kartenzeichnung für die Blog-Übersicht, Ausführen des Build-Prozesses zur Validierung und Vorschlagen von LinkedIn-Teasern. Es unterstützt Plattformen wie Cursor, Claude Code und Codex, die SKILL.md-Dateien verarbeiten, und ist für Entwickler und technische Autoren gedacht, die einen wiederholbaren, qualitätsgesicherten Publishing-Prozess für ihre Website benotigen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/fkramer690/homepage/tree/HEAD/.claude/skills/blog-article

In Ihrer bevorzugten KI fragen

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

Dokumentation

Einen Blogartikel schreiben

  1. Lies docs/blog-guidelines.md vollständig. Dessen Regeln sind bindend.
  2. Kopiere docs/blog-template.md nach src/content/blog/en/<slug>.md und schreibe die englische Version.
  3. Schreibe die deutsche Version in src/content/blog/de/<deutscher-slug>.md mit demselben translationKey. Lokalisiere, verwende „Sie“.
  4. Verwende ausschließlich Erfahrungen und Beispiele, die Fabian bestätigt hat (Briefing, Projektgedächtnis, seine Nachrichten). Frage ihn, wenn ein Beispiel fehlt, anstatt eines zu erfinden.
  5. Führe eine „Slop-Überprüfung“ beider Versionen durch (siehe „No AI slop“ in den Richtlinien): Lösche jeden Satz, der in jeden beliebigen Artikel passen würde, ersetze allgemeine Behauptungen durch Fabians konkrete Fakten, lies ihn einmal laut vor.
  6. Zeichne das Kartenbild für die Blog-Übersicht: Füge einen Eintrag für den translationKey des Artikels in src/lib/card-drawings.ts hinzu (leichte technische Zeichnung, EN/DE-Beschriftungen mit Fakten aus dem Artikel, siehe „Kartenbild“ in den Richtlinien). Jeder Artikel erhält eines; der Build schlägt ohne ihn fehl.
  7. Setze draft: false, wenn der Artikel fertig ist, und führe dann npm run build aus. Behebe jede Meldung von check-blog.mjs oder dem Inhaltsschema.
  8. Betrachte die erstellte Artikelseite einmal, sowie die Karte auf /blog/ mit ihrer Zeichnung (Takeaways-Box oben, einklappbare FAQ, Autorenbox, Kontaktbereich mit „Buch einen Anruf“ und dem Kontaktformular unten) und das generierte Vorschaubild in dist/og/<lang>/<slug>.png. Schlage ein erklärendes Schaubild vor, wenn das Thema von einem profitiert (siehe Bilder in den Richtlinien).
  9. Öffne den Pull Request und füge 2–3 LinkedIn-Teaser-Entwürfe für Fabian hinzu, entweder als PR-Beschreibung oder im Thread.

Ändere die Vorlagenkomponenten (src/components/BlogPost.astro, BlogIndex.astro) nicht für einen einzelnen Artikel. Layout-Änderungen gelten für alle Artikel.

Verwandte Skills