Communitygithub.com

Gyschuaner/von-der-Idee-zur-persönlichen-Website

Verwende diesen Skill, um einen oder mehrere Blogbeiträge, Notizen, Essays, Artikel, Markdown-Dateien, Word-Dokumente oder Ordner mit umfangreichen Inhalten zu einer bestehenden statischen persönlichen Website oder einem Blog hinzuzufügen, zu importieren oder zu migrieren. Dabei bleiben der aktuelle Artikelstil, die Inhaltsstruktur, Navigation, Indizes, Archive, Tags, Assets, mathematische Ausdrücke, Links, Tabellen, Codeblöcke, Einbettungen und Einstiegspunkte der Startseite erhalten. Verwende ihn für eingefügte Beiträge, lokale Markdown-Dateien, Obsidian-Notizen, .docx-Entwürfe, alte statische HTML-Beiträge, exportierte Blog-Inhalte oder kleine bis mittlere Beitragsmengen, nachdem eine Website bereits erstellt wurde.

Was ist von-der-Idee-zur-persönlichen-Website?

Dieser Skill ermöglicht das nahtlose Hinzufügen neuer Inhalte zu einer bestehenden statischen Website, ohne das bestehende Blogsystem zu ersetzen. Er analysiert zunächst die aktuelle Darstellung von Beiträgen, einschließlich der Verwendung von Artikeln, Indizes, Archiven, Tags und Assets, und fügt dann neue Inhalte in genau diesem Stil hinzu. Unterstützt werden Quellen wie Markdown, Obsidian-Notizen, Word-Dokumente, alte HTML-Dateien und eingefügter Text. Der Skill stellt sicher, dass neue Seiten in das bestehende Layout und die Navigation integriert werden, dass Bilder und Anhänge korrekt verlinkt werden und dass alle Einstiegspunkte (Blog-Index, Archiv, Tags, Startseite) aktualisiert werden. Er eignet sich ideal für Entwickler und Content-Ersteller, die ihre statische Website (generiert mit Tools wie Hugo, Jekyll, Eleventy oder einem einfachen HTML-Setup) um neue Inhalte erweitern möchten, ohne manuelle Anpassungen vorzunehmen und ohne das Risiko, das bestehende Design zu beeinträchtigen.

Funktioniert mit~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Gyschuaner/from-idea-to-personal-site/tree/HEAD/.agents/skills/add-blog-posts

In Ihrer bevorzugten KI fragen

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

Dokumentation

Blogbeiträge hinzufügen

Ziel

Benutzerinhalte zu einem bestehenden statischen Blog hinzufügen, ohne ein neues Blogsystem zu erzwingen.

Dieser Skill muss zuerst verstehen, wie die aktuelle Website Beiträge bereits darstellt, und dann neue Inhalte in diesem Stil hinzufügen. Er ist kein generischer Markdown-zu-HTML-Konverter.

Vertrag

Eingaben:

  • Vorhandener statischer Site-Ordner und sein aktuelles Beitrags-/Index-/Vorlagensystem.
  • Ein oder mehrere Quellbeiträge: Markdown, Obsidian-Notizen, Word-Dokumente, altes HTML, eingefügter Text, Bilder, Anhänge oder Inhaltsordner.
  • Optionale Metadaten wie Titel, Datum, Tags, Zusammenfassung, Slug, Titelbild und Importumfang.

Ausgaben:

  • Neue Artikel-/Detailseiten, die dem vorhandenen Artikelstil der Website entsprechen.
  • Aktualisierte Einstiegspunkte wie Blog-Index, Archiv, Tags/Kategorien, aktuelle Beiträge auf der Startseite, Suchdaten, RSS oder Sitemap, wenn diese Systeme bereits vorhanden sind.
  • Kopierte/neu verlinkte lokale Bilder und Anhänge mit seitenrelativen Pfaden.
  • Aktualisierte EDITING.md-Beitragsanweisungen, sofern zutreffend.

Grenzen:

  • Die Website nicht neu gestalten oder ein neues Beitragssystem erstellen, wenn ein vorhandenes klar ist.
  • Keine Metadaten, Daten, Autoren oder Behauptungen erfinden, die die Quelle nicht unterstützt.
  • Keine entfernten Mathe-/CDN-Abhängigkeiten stillschweigend hinzufügen.
  • Nicht veröffentlichen; publish-static-site verwenden.

Erfolgskriterium:

  • Neue Beiträge werden im vorhandenen Stil gerendert und sind über die entsprechenden Indizes erreichbar.
  • Bilder, Mathe, Links, Code, Tabellen und umfangreiche Inhalte funktionieren oder ungelöste Elemente werden explizit gemeldet.
  • Pfade sind seitenrelativ von Artikel- und Indexseiten aus.
  • Betroffene Seiten bestehen die Browser-Validierung und review-static-site kann bestehen oder nur akzeptierte Einschränkungen melden.

Bei Fehlschlagen des Kriteriums:

  • Konvertierung, Metadaten, Pfade, Assets oder Index-Verknüpfungen in diesem Skill korrigieren.
  • edit-site-part für kleine visuelle Korrekturen verwenden, die durch den Import verursacht wurden.
  • review-static-site nach den Korrekturen erneut ausführen.

Verwendung

Diesen Skill verwenden, wenn der Benutzer Folgendes möchte:

  • Einen neuen Artikel, eine Notiz, einen Essay oder einen Blogbeitrag hinzufügen.
  • Mehrere Markdown-Dateien in eine statische Website importieren.
  • Beiträge von einem alten Blog in eine neue generierte Website verschieben.
  • Eingefügten Artikeltext in eine Artikel-Seite der Website konvertieren.
  • Den Blog-Index, das Archiv, die Tags, die aktuellen Beiträge auf der Startseite oder verwandte Einstiegspunkte aktualisieren.
  • Die visuelle Sprache der aktuellen Website beim Hinzufügen von Inhalten beibehalten.

Diesen Skill nicht verwenden, um ein Theme auszuwählen, eine neue Website von Grund auf zu erstellen, den Stil einer Website neu zu erstellen, Profil-/Über-Inhalte zu personalisieren, eine kleine visuelle Anpassung vorzunehmen, die Website zu veröffentlichen oder das Projekt in ein Framework zu konvertieren.

Eingaben

Verwenden, was verfügbar ist:

  • Statischer Site-Ordner, normalerweise site/, dist/, out/ oder public/.
  • Eine oder mehrere Markdown-Dateien, Word-Dokumente, eingefügte Beiträge, alte HTML-Dateien, Bildordner oder Inhaltsordner.
  • EDITING.md, Seitenübersicht oder Übergabenotizen von vorherigen Skills.
  • Vorhandene Artikel-Vorlagenseiten oder repräsentative Beiträge.
  • Vom Benutzer bereitgestellter Titel, Datum, Tags, Kategorie, Zusammenfassung, Slug, Titelbild und Veröffentlichungspräferenz.
  • Ob alle Beiträge, eine ausgewählte Teilmenge oder zuerst ein repräsentativer Batch importiert werden soll.

Wenn der Quellinhalt groß ist, zuerst die Struktur überprüfen und vermeiden, alles blind zu importieren.

1. Das vorhandene Beitragssystem verstehen

Bevor neue Beiträge geschrieben werden, überprüfen, wie die Website derzeit funktioniert.

Prüfen auf:

  • Beitragsdateien wie posts/*.html, notes/*.html, articles/*.html oder verschachtelte Routenordner.
  • Indexseiten wie blog.html, archive/index.html, notes/index.html, tags/index.html oder category/index.html.
  • Datendateien wie data/posts.json, data/notes.json, data/site.json oder profile.json.
  • JavaScript-Datenarrays in assets/script.js oder ähnlichen Dateien.
  • Startseitenabschnitte für aktuelle Beiträge, vorgestellte Beiträge, Notizen, Leselisten oder Schreiber-Highlights.
  • Vorhandene Artikel-/Detailseiten, die als Vorlagen verwendet werden können.
  • Vorhandene Pfadstrategie: Ob Vorlagen seitenrelative Links wie ../assets/style.css oder Server-Stamm-Links wie /assets/style.css verwenden.
  • RSS, Atom, Sitemap, Suchindex oder Tag-/Kategorieseiten, falls bereits vorhanden.
  • EDITING.md-Anweisungen zum Hinzufügen von Beiträgen.
  • Vorhandene Bild- und Anhangskonventionen, wie assets/images/posts/, kollokierte Beitragsordner, Cover-Felder, Figure-Klassen, Lightbox-Markup, Bildunterschriften oder responsive Bild-Wrapper.
  • Vorhandene Konventionen für umfangreiche Inhalte, wie Mathe-Rendering, Code-Highlighting, Tabellen, Fußnoten, Callouts, Überschriftenanker, Inhaltsverzeichnis, Linkkarten, Einbettungen, Diagramme und Zitier-/Referenzabschnitte.

Der vorhandenen Struktur folgen. Kein neues Beitragssystem erfinden, wenn die Website bereits eines hat.

2. Metadaten von Beiträgen extrahieren

Für jeden Quellbeitrag Folgendes extrahieren oder ableiten:

  • Titel.
  • Datum.
  • Slug.
  • Tags oder Kategorie.
  • Zusammenfassung oder Auszug.
  • Titelbild oder Heldenbild, falls vorhanden und verwendbar.
  • Quellpfad.
  • Lesezeit, nur wenn die aktuelle Website sie bereits verwendet oder sie einfach konsistent zu berechnen ist.

Frontmatter verwenden, wenn vorhanden. Andernfalls aus der ersten Überschrift, dem Dateinamen, dem umgebenden Ordner, dem sichtbaren Datumstext oder dem ersten Absatz ableiten.

Keine spezifischen Daten, Tags, Autoren oder Behauptungen erfinden. Wenn ein Feld fehlt und nicht abgeleitet werden kann, einen klaren Platzhalter verwenden oder das Feld weglassen, wenn es der Seitenstil erlaubt.

3. Inhalt an den Stil der Website anpassen

Neue Artikelseiten erstellen, indem die vorhandene Artikelvorlage und das Leseerlebnis nachgeahmt werden.

Beibehalten:

  • Kopfzeile, Navigation, Fußzeile, Seitenleisten und gemeinsame Hülle.
  • Artikeltypografie, Abstände, Metadaten-Layout, Tags, Backlinks und verwandte Links.
  • Jegliche spezielle Themensprache, wie Logeinträge, Feldnotizen, Karten, Terminal-/Archiv-Rahmen oder minimalistische Essays.
  • Vorhandene CSS-Klassenkonventionen und Datenstrukturen.

Für Markdown:

  • Überschriften, Absätze, Blockzitate, Listen, Aufgabenlisten, Tabellen, Codeblöcke, Links, Fußnoten, Callouts und Bilder in semantisches HTML konvertieren.
  • Code-Sprachbezeichnungen beibehalten, wenn verfügbar.
  • Bildreferenzen seitenrelativ halten und lokale Bilder nur bei Bedarf kopieren.
  • Chinesischen, japanischen, koreanischen, akzentuierten lateinischen und anderen nicht-ASCII-Text als lesbares UTF-8 beibehalten.

Für altes HTML:

  • Den Artikelkörper und die Metadaten extrahieren.
  • Altes Site-Chrome, Analysen, Kommentare, nicht zusammenhängende Navigation und die Identität der Quellseite entfernen.
  • Den Inhalt in die Artikelvorlage der neuen Website einpacken.

3.5. Statische Pfadkompatibilität beibehalten

Beim Hinzufügen von Beiträgen Pfade vom Speicherort jeder generierten Seite aus berechnen. Pfade nicht blind von index.html in verschachtelte Artikelseiten kopieren.

Standardregeln:

  • Neue Artikelseiten sollten seitenrelative Links für gemeinsames CSS, JavaScript, Schriftarten, Bilder und Navigation verwenden.
  • Wenn der Beitrag unter posts/my-post.html generiert wird, benötigen gemeinsame Assets normalerweise ../assets/style.css, ../assets/script.js und Beitragsbilder wie ../assets/images/posts/my-post/figure.png.
  • Links von Stammseiten zum Beitrag sollten normalerweise posts/my-post.html sein.
  • Links vom Beitrag zurück zu Stammseiten sollten normalerweise ../index.html, ../blog.html oder ../archive/index.html sein, abhängig von der Struktur.
  • Keine stammabsoluten Pfade wie /assets/..., /posts/..., /data/... oder /images/... einführen, es sei denn, die vorhandene Website verwendet sie absichtlich und der Benutzer akzeptiert, dass das direkte Öffnen von file:// und das Hosting in Unterpfaden möglicherweise nicht mehr funktioniert.
  • JavaScript-generierte Links, Suchergebnisse, Tag-Filter, verwandte Beitragslinks, Cover-Pfade, RSS/Sitemap-Einträge und alle Datendateien mit derselben Pfadstrategie aktualisieren.
  • Wenn die vorhandene Website bereits versehentlich stammabsolute Links hat, dies melden und vorziehen, die betroffenen Pfade zu korrigieren, anstatt das Problem zu erweitern.

Lokale Datei-Fetch-Probleme vermeiden:

  • Neu hinzugefügte Beiträge nicht von fetch() von lokalem JSON/Markdown für den Artikelkörper abhängig machen.
  • Wenn Indizes aus Daten gerendert werden, wesentliche Beitragslinks im HTML sichtbar halten oder ein relatives JavaScript-Datenobjekt verwenden, das mit der Direktvorschau funktioniert.

4. Umfangreiche Inhaltsformate handhaben

Umfangreiche Inhalte absichtlich beibehalten, anstatt alles in einfache Absätze zu glätten.

Zunächst prüfen, ob die aktuelle Website bereits Folgendes unterstützt:

  • Mathe-Rendering mit KaTeX, MathJax, benutzerdefiniertem CSS oder rohen TeX-Blöcken.
  • Code-Highlighting, Sprachbezeichnungen, Kopier-Buttons oder terminalartige Code-Rahmen.
  • Tabellen, responsive Tabellen-Wrapper, Fußnoten, Callouts, Hinweise, Zitate und Aufgabenlisten.
  • Überschriftenanker, Inhaltsverzeichnis, Backlinks, verwandte Notizen oder Abschnittslinks.
  • Linkkarten, Lesezeichenlisten, URL-Indexseiten, Zitate, Referenzlisten oder Bibliographie-Abschnitte.
  • Eingebettete Medien wie Video, Audio, PDFs, iframes, Mermaid-Diagramme, Excalidraw/SVG-Diagramme oder herunterladbare Anhänge.

Dem vorhandenen Muster folgen, wenn eines existiert. Wenn kein Muster existiert, einfaches semantisches HTML verwenden und alle Funktionen melden, die einen zusätzlichen Renderer benötigen.

Mathe und Formeln:

  • Inline- und Display-Mathe aus $...$, $$...$$, \(...\), \[...\] oder Word-Gleichungsexporten beibehalten.
  • Den vorhandenen Mathe-Renderer der Website verwenden, falls vorhanden.
  • Wenn die Quelle viele Formeln enthält und kein Renderer existiert, eine lokale KaTeX-Integration für statische Seiten bevorzugen: KaTeX CSS/JS/Schriftarten in einem lokalen vendor-Ordner speichern, ein kleines lokales Render-Skript hinzufügen und nicht auf ein CDN angewiesen sein.
  • Keine entfernte MathJax/KaTeX-Abhängigkeit stillschweigend zu einer ansonsten abhängigkeitsfreien Website hinzufügen.
  • Das ursprüngliche TeX in mathematisch markierten Elementen als Fallback beibehalten und dann im Browser rendern. Wenn das Rendern einer Formel fehlschlägt, sollte der lesbare TeX-Fallback sichtbar bleiben, anstatt die Seite zu beschädigen.
  • Offensichtliche Quellsyntax normalisieren, die KaTeX benötigt, wie Softmax-Pfeile, \cdot, \times, versehentlich in Formeln gemischte Satzzeichen und häufige Q/K/V-Ausdrücke.
  • Keine formelreichen Beiträge als codeartige TeX-Blöcke belassen, wenn ein Mathe-Renderer hinzugefügt wurde.
  • Formeln in der Quelle und im Browser-Fallback lesbar halten.

Codeblöcke:

  • Code-Sprachbezeichnungen in Fenced-Blöcken beibehalten.
  • HTML in Codeblöcken escapen.
  • Lange Codezeilen scrollbar halten, anstatt das Seitenlayout zu beschädigen.
  • Vorhandene Codeblock-Stile, Kopier-Buttons und Syntax-Highlighting-Konventionen wiederverwenden.
  • Quellcode aus Beiträgen nicht ausführen.

Tabellen:

  • Markdown-, Word- oder HTML-Tabellen in semantische Tabellen konvertieren.
  • Breite Tabellen in den vorhandenen responsiven Tabellen-Container der Website einwickeln oder einen kleinen lokalen Wrapper hinzufügen.
  • Kopfzeilen, Ausrichtungsabsicht und Bildunterschriften beibehalten, wenn verfügbar.

Links, URL-Indizes und interne Verweise:

  • Externe Links mit klarem Linktext beibehalten.
  • Relative Links und Markdown-.md-Links in den generierten statischen HTML-Pfad konvertieren, wenn der Zielbeitrag importiert wird.
  • Obsidian-Wikilinks wie [[Notiz]], [[Notiz#Überschrift]] und [[Notiz|Alias]] in normale Links konvertieren, wenn das Ziel aufgelöst werden kann.
  • Ungelöste interne Links als sichtbare Platzhalter oder Klartext beibehalten und melden.
  • Stabile Überschriften-IDs generieren, wenn die Website Ankerlinks oder ein Inhaltsverzeichnis verwendet.
  • Bei URL-Index-, Lesezeichen- oder Link-Roundup-Beiträgen die Listenstruktur beibehalten. Den vorhandenen Linkkarten-/Listenstil der Website verwenden, wenn vorhanden; keine Vorschaubilder erfinden, die das Abrufen entfernter Metadaten erfordern, es sei denn, der Benutzer fragt danach.

Fußnoten, Zitate und Referenzen:

  • Markdown-Fußnoten in einen Fußnotenabschnitt konvertieren, wobei der vorhandene Stil der Website verwendet wird, falls vorhanden.
  • Zitierbezeichnungen, Bibliographieeinträge und Referenzlinks beibehalten.
  • Wenn der Quelltext ungelöste Zitierschlüssel wie [@paper2024] verwendet, diese sichtbar lassen und melden, dass Zitiermetadaten fehlen, es sei denn, eine Bibliographiedatei wird bereitgestellt.

Callouts, Hinweise und Blocktypen:

  • Obsidian/GitHub-ähnliche Callouts wie > [!NOTE], > [!TIP], > [!WARNING] und > [!IMPORTANT] in das nächstgelegene Callout-/Karten-/Blockzitatmuster der Website konvertieren.
  • Aufgabenlisten als Checklisten beibehalten, wenn die aktuelle Website Checkbox-Stile hat; andernfalls deaktivierte Kontrollkästchen-Markups oder einfache Listen verwenden.

Einbettungen und Anhänge:

  • Für PDFs, Folien, Datensätze, Downloads, Audio und Video einen klaren Link oder eine Download-Karte bevorzugen, es sei denn, die Website bettet diesen Medientyp bereits ein.
  • Lokale Anhänge nur kopieren, wenn sie vom Benutzer bereitgestellt werden.
  • Entfernte Einbettungen nur beibehalten, wenn der Benutzer sie besitzt oder absichtlich darauf verweist.
  • Für Mermaid- oder Diagrammblöcke den vorhandenen Renderer verwenden, falls vorhanden. Wenn kein Renderer existiert, den Quellblock beibehalten und melden oder nur dann in ein statisches SVG/PNG konvertieren, wenn es praktisch und angemessen ist.

5. Beitragsbilder und -assets handhaben

Bilder gemäß den vorhandenen Asset-Konventionen der Website handhaben.

Zunächst prüfen, wie vorhandene Beiträge Bilder speichern und rendern:

  • Gemeinsamer Asset-Ordner wie assets/images/posts/<slug>/.
  • Kollokierte Beitrags-Assets wie posts/<slug>/images/.
  • Datenfelder wie cover, heroImage, thumbnail oder images.
  • Figure-Markup, Bildunterschriften, Lightbox-Links, Lazy Loading, Breite-/Höhenattribute und responsive CSS-Klassen.

Das vorhandene Muster bevorzugen. Wenn kein Muster existiert, eine einfache statische Konvention verwenden wie:

assets/images/posts/<post-slug>/

Für Markdown-Quellen:

  • Relative Bildlinks aus dem Ordner der Markdown-Datei auflösen.
  • Lokale Bilder bei Bedarf in den Beitragsbildordner der Website kopieren.
  • Markdown-Bildreferenzen in die neuen relativen Website-Pfade umschreiben.
  • Für verschachtelte Artikelseiten die korrekte ../-Tiefe in Bildpfaden einfügen.
  • Alt-Text aus Markdown beibehalten, wenn vorhanden.
  • Bildunterschriften konvertieren, wenn die Quelle benachbarten kursiven Text, Titelattribute oder Obsidian-ähnliche Einbettungen verwendet.
  • Keine Links hinterlassen, die auf absolute lokale Festplattenpfade verweisen.

Für Obsidian-Notizen:

  • Häufige Einbettungen wie ![[image.png]] und relative Anhangsordner unterstützen.
  • Wahrscheinliche Anhangsordner in der Nähe der Notiz durchsuchen, wie attachments/, assets/, images/ oder den konfigurierten Anhangsordner der Wissensdatenbank, wenn sichtbar.
  • Einbettungen in normales HTML-Bild- oder Figure-Markup umschreiben.

Für Word .docx-Quellen:

  • Eingebettete Bilder aus dem Dokumentpaket extrahieren oder verfügbare Dokumentwerkzeuge verwenden.
  • Die Bildreihenfolge relativ zum umgebenden Text beibehalten, wenn möglich.
  • Extrahierte Bilder unter dem Beitragsbildordner mit stabilen Namen speichern.
  • Benachbarte Bildunterschriften oder Alt-Text verwenden, wenn verfügbar.

6. Indizes und Einstiegspunkte aktualisieren

Nachdem neue Beiträge geschrieben wurden, alle vorhandenen Indizes und Navigationen aktualisieren, um sie einzubeziehen.

Prüfen und aktualisieren:

  • Blog-Startseite, Index, Archiv oder blog.html.
  • Kategorie- oder Tag-Seiten und deren Indizes.
  • Abschnitt „Neueste Beiträge“ oder „Vorgestellte Beiträge“ auf der Startseite.
  • RSS / Atom-Feed.
  • Sitemap.
  • Suchdatendatei oder clientseitiges Suchindex-JSON.
  • Daten-JSON wie data/posts.json oder data/notes.json.
  • Verwandte Beitragslisten oder Abschnitte „Weiterlesen“ in Artikeln.
  • Paginierung, wenn vorhanden.
  • Link-Roundup- oder URL-Index-Seiten, falls zutreffend.
  • EDITING.md, wenn es eine Beitragsliste enthält.

Dieselbe Sortier- und Filterlogik wie der vorhandene Index der Website verwenden. Beiträge nicht nach einem neuen Schema sortieren.

Wenn die Website Paginierung verwendet, neue Beiträge in die richtigen Seiten einfügen.

Wenn die Website mehrere Beitragstypen hat (Blog, Notizen, Artikel, Logs), jede neue Seite in ihren richtigen Abschnittsindex einfügen.

Diesen Schritt nicht überspringen. Ein Beitrag, der nicht mit einem Index verknüpft ist, ist unsichtbar.

7. Überprüfen und testen

Nach dem Hinzufügen von Inhalten validieren, ob alles funktioniert.

Testen:

  • Dass alle neuen Seiten vom Browser ohne Fehler gerendert werden.
  • Dass Bilder und Anhänge relativ zur Seite laden.
  • Dass Links innerhalb der Website funktionieren und zu den richtigen Seiten führen.
  • Dass Mathe, Code-Blöcke und umfangreiche Inhalte korrekt gerendert werden.
  • Dass Indizes und Navigation aktualisiert wurden und alle neuen Beiträge einschließen.
  • Dass keine Abhängigkeiten von entfernten Ressourcen hinzugefügt wurden (insbesondere für Mathe-Rendering), die der Benutzer nicht erwartet.

review-static-site verwenden, um die allgemeine Gültigkeit der Website zu überprüfen.

Wenn etwas defekt ist:

  • Probleme in diesem Skill protokollieren.
  • edit-site-part für kleine visuelle Korrekturen verwenden.
  • Den Schritt wiederholen, bis der Test erfolgreich ist.

Häufige Probleme

  • Pfade: Vergessen, die Tiefe für seitenrelative Links in verschachtelten Artikelseiten anzupassen. Teste Links sowohl von der Stammseite als auch von der Artikelseite.
  • Fehlende Assets: Lokale Bilder oder Anhänge nicht kopiert. Alte Pfade hinterlassen.
  • Indizes nicht aktualisiert: Der Blog-Index, die Startseite oder Tag-Seiten enthalten keine neuen Beiträge.
  • Unveränderter Frontmatter: Das Datum/die Tags des Beitrags nicht aus Frontmatter abgeleitet, wenn verfügbar.
  • Mathe-Abhängigkeiten: Stilles Hinzufügen eines CDN für Mathe-Rendering, wenn der Benutzer die Website offline oder ohne CDN-Abhängigkeit haben möchte.
  • CMS-spezifische Syntax: Nicht konvertierte Obsidian-Wikilinks oder Hugo-Kurzcodes, die in der generierten Ausgabe erscheinen.

Zusammenfassung der Schritte

  1. Das vorhandene Beitragssystem verstehen
  2. Metadaten aus Quellen extrahieren
  3. Inhalte an den Stil der Website anpassen
  4. Pfadkompatibilität beibehalten
  5. Umfangreiche Formate (Mathe, Code, Tabellen, Links, Fußnoten, Callouts, Einbettungen) handhaben
  6. Bilder und Assets gemäß den Site-Konventionen handhaben
  7. Indizes, Navigation und Einstiegspunkte aktualisieren
  8. Testen und validieren

Diese Reihenfolge einhalten. Einen Schritt nicht überspringen, nur weil er einfach erscheint.

Beziehung zu anderen Skills

  • get-site-spec wird verwendet, um die Website anfangs zu verstehen. Wenn sie noch nicht ausgeführt wurde, jetzt ausführen: Führe get-site-spec aus und lies die Ausgabe, um die Site-Architektur und -Konventionen zu verstehen.
  • edit-site-part wird für kleine visuelle Korrekturen nach dem Import verwendet, z. B. um ein Ungleichgewicht im Abstand oder eine falsch ausgerichtete Schaltfläche zu beheben.
  • review-static-site wird verwendet, um zu überprüfen, ob die Änderungen gültig sind.
  • publish-static-site wird verwendet, um die Website nach Fertigstellung zu veröffentlichen.
  • Dieser Skill ist so konzipiert, dass er unabhängig von der verwendeten Technologie ist: Hugo, Jekyll, Eleventy, Astro, Next.js, einfaches HTML, 11ty, Zola oder ein anderes statisches Site-Generierungssystem.

⚠️ Wichtig: Lese vor der Ausführung die README der Website. Die README könnte Konventionen dokumentieren, die hier nicht beschrieben sind, oder wichtige Workflow-Anweisungen enthalten. Lese während der Ausführung auch site.json oder das Äquivalent, falls vorhanden; die Site-Konfiguration spezifiziert oft die tatsächliche Verzeichnisstruktur, die sich von den hier gezeigten Beispielen unterscheiden kann.

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

Gyschuaner/from-idea-to-personal-site

Route and coordinate the personal website skill suite for creating, recreating, personalizing, adding content to, validating, editing, or preparing a static personal website or blog. Use when the agent needs to choose between theme search, style reference research, original build, website style recreation, personalization, post import, review, local edits, or publishing preparation, or when the user asks what step comes next in an existing site-building workflow.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to recreate, copy, clone, remix, or closely match the look, layout, motion, or interaction feel of a specific website, URL, screenshot, or template using plain HTML, CSS, and JavaScript. Use it to inspect public source as research, rewrite original code, avoid direct reuse of protected assets, and validate the result in a browser.

Gyschuaner/from-idea-to-personal-site

Use this skill to make focused, small-scope edits to a generated static website, personal blog, portfolio, digital garden, or style recreation. Use it when the user wants to adjust one page section, component, visual detail, copy block, responsive issue, or lightweight interaction without rebuilding the whole site. Typical requests include changing a hero block, card layout, sidebar, footer, button, mobile menu, spacing, color, typography, animation intensity, or a small piece of page copy.

Gyschuaner/from-idea-to-personal-site

Use this skill after a personal website or blog style direction is roughly known and before building an original site. It searches for real websites, templates, portfolios, blogs, screenshots, or design examples that match the chosen direction, inspects them with browser or screenshot tools when available, and turns the findings into a practical design reference brief for make-personal-site. Use it for requests like finding references for a natural technical blog, cozy research homepage, brutalist portfolio, digital garden, minimal notes site, or any named visual direction that still needs concrete examples.

Gyschuaner/from-idea-to-personal-site

Run the complete idea-to-personal-website or blog workflow. Use when the user wants a one-click or end-to-end pipeline from a vague idea, reference URL, template, personal materials, style direction, or writing drafts to concrete style references, a validated static personal site, and optionally a live deployment on GitHub Pages, Cloudflare Pages, Netlify, or Vercel.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to create, implement, redesign, or update a zero-dependency personal website, personal blog, homepage, portfolio, research homepage, or digital garden using plain HTML, CSS, and JavaScript. Use it after a theme direction has been chosen, or when the user wants a no-framework site that can be opened directly in the browser and deployed as static files.

Gyschuaner/from-idea-to-personal-site

Use this skill to turn a generated static personal website, blog, portfolio, digital garden, or style recreation into the user's own site by replacing placeholder identity, profile copy, links, projects, featured items, contact details, metadata, and demo page content. Use it after make-personal-site or copy-website-style, or when a user provides an existing static site folder and personal materials such as a bio, resume, README, GitHub profile, old homepage, Markdown notes, or social links.

Gyschuaner/from-idea-to-personal-site

Publish, deploy, or prepare a finished static personal website, blog, portfolio, or style recreation for hosting on GitHub Pages, Cloudflare Pages, Netlify, or Vercel. Use when the user asks to publish a static site, configure deployment settings, add GitHub Pages workflows, choose a static hosting platform, prepare a repo for Pages/Cloudflare/Netlify/Vercel, verify a deployed URL, or explain how to deploy a site folder such as site/, dist/, out/, public/, or docs/.

Gyschuaner/from-idea-to-personal-site

Use this skill to inspect, validate, QA, or sanity-check a generated static website, personal blog, portfolio, digital garden, or style recreation before handoff or publishing. Use it for local folders such as site/, dist/, out/, or public/ to check broken links, missing page types, browser rendering, console errors, desktop/mobile screenshots, UTF-8 source readability, mojibake, relative asset paths, direct-open/file compatibility, placeholder content, and leftover copied source-specific text.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to find, compare, choose, or adapt a visual theme for a personal blog, personal homepage, portfolio, research homepage, digital garden, or static website. Use it to turn references from v0, Figma, GitHub themes, existing websites, screenshots, keywords, or natural-language taste preferences into natural, practical theme recommendations.

Verwandte Skills