Was macht Persönliche Website erstellen?
Ziel
Eine persönliche Website als reine statische Dateien erstellen oder neu gestalten: HTML, CSS und optionales Vanilla-JavaScript.
Dieser Skill ist der Implementierungsschritt, nachdem eine visuelle Richtung gewählt wurde. Er wandelt eine Themenempfehlung, ein Nutzerprofil, Notizen, Beispielbeiträge, Projektbeschreibungen oder einen vorhandenen statischen Site-Ordner in eine funktionierende persönliche Website um.
Kernversprechen:
- Kein Framework.
- Kein Build-Schritt.
- Keine Paketinstallation.
- Keine Laufzeitabhängigkeit.
index.htmldirekt zur manuellen Vorschau öffnen.- Seitenrelative Links und Assets verwenden, sodass direktes Öffnen der Datei, lokales HTTP und statisches Hosting funktionieren.
- Den Ordner auf statischem Hosting bereitstellen.
Für automatisierte Browser-QA den statischen Ordner über lokalem HTTP statt file://-URLs bereitstellen.
Vertrag
Eingaben:
- Themenrichtung, Nutzerprofilmaterialien, Seitenanforderungen, Beispielinhalte oder ein vorhandener statischer Ordner.
- Optionale Referenzen, die den Stil leiten sollen, ohne eine originalgetreue Nachbildung zu erfordern.
- Gewünschter Ausgabeordner und statische Einschränkungen.
Ausgaben:
- Ein reiner statischer Site-Ordner mit HTML, CSS, optionalem Vanilla-JavaScript, lokalen Assets und repräsentativen Seitentypen.
EDITING.mdfür zukünftige Bearbeitungen, wenn eine neue Website oder ein materielles Redesign erstellt wird.- Lokale Vorschauanweisungen und Validierungszusammenfassung.
Grenzen:
- Keine originalgetreue Nachbildung einer bestimmten Zielwebsite;
copy-website-styleverwenden. - Keine großen Schreibarchive importieren;
add-blog-postsverwenden. - Nicht veröffentlichen oder Hosting konfigurieren;
publish-static-siteverwenden. - Keine Frameworks, Paketinstallationen, Backends, CMS, Authentifizierung oder Datenbanken einführen, es sei denn, der Nutzer fragt explizit danach.
Erfolgsbedingung:
- Erforderliche Seitentypen existieren und die Navigation verweist auf reale relative Pfade.
- Die Website funktioniert als reine statische Dateien ohne Build-Schritt.
- Der Quellcode ist UTF-8-lesbar, Platzhalter sind klar und
review-static-sitekann bestehen oder nur akzeptierte Einschränkungen melden.
Wenn die Bedingung fehlschlägt:
- Fehlende Seitentypen, Pfade, Assets, Kodierung, Platzhalter oder Browserprobleme innerhalb dieses Skills beheben.
personalize-siteverwenden, wenn der Fehler auf fehlende Nutzeridentität/-inhalte zurückzuführen ist.- Nach Korrekturen erneut
review-static-siteverwenden.
Kurze Pipeline
Diese Pipeline für originäre persönliche Website-Arbeiten befolgen:
- Den Zweck der Website, die Themenrichtung, verfügbare Inhalte und den Seitenumfang klären.
- Vor dem Codieren die statische Seitenkarte und Platzhalterstrategie festlegen.
- Zuerst die gemeinsame Hülle bauen: Header, Navigation, Hauptlayout, Footer, globale CSS-Variablen und gemeinsame Interaktionen.
- Die Startseite und jeden angefragten oder implizierten Seitentyp implementieren.
- Die Inhalte des Nutzers oder klar ersetzbare Platzhalter verwenden; keine detaillierte persönliche Identität erfinden.
- Einen Bearbeitungsleitfaden für zukünftige Modell-/Nutzerbearbeitungen hinzufügen.
- Die Kompatibilität mit direktem Öffnen von Pfaden mit relativen Links und Assets überprüfen.
- Lokal über HTTP in einem echten Browser validieren.
- Links, Assets, Seitentypen und UTF-8-Quellcodes-Lesbarkeit vor der endgültigen Auslieferung überprüfen.
Verwenden, wenn
Diesen Skill verwenden, wenn der Nutzer:
- Eine reine HTML/CSS/JS persönliche Website, einen Blog, eine Homepage, ein Portfolio, eine Forschungs-Homepage oder eine statische Website wünscht.
- Eine von
search-blog-themeerstellte Themenrichtung implementieren möchte. - Eine einfache, framework-freie Website wünscht, die leicht zu inspizieren, zu bearbeiten und bereitzustellen ist.
- Eine bestehende statische Website neu gestalten möchte, dabei aber dependencies-frei bleiben will.
- Lockere visuelle Referenzen bereitstellt, aber keine originalgetreue Nachbildung benötigt.
Nicht verwenden, wenn
Diesen Skill nicht verwenden, wenn:
- Der Nutzer nur nach Themes suchen oder visuelle Referenzen vergleichen möchte.
search-blog-themeverwenden. - Der Nutzer das Aussehen, Layout, Bewegung oder Interaktionsgefühl einer bestimmten Website originalgetreu nachbilden möchte.
copy-website-styleverwenden. - Der Nutzer viele Beiträge migrieren, Obsidian-Notizen konvertieren, Frontmatter reparieren oder große Inhaltsarchive verschieben möchte.
add-blog-postsverwenden. - Der Nutzer nur Hilfe bei der Bereitstellung, DNS, GitHub Pages, Cloudflare Pages, Cloudflare Pages Direct Upload, Netlify oder Vercel benötigt.
publish-static-siteverwenden. - Der Nutzer explizit nach einem Framework-Projekt wie Next.js, Astro, Hugo, Jekyll, Quartz oder React fragt.
- Der Nutzer nach einem Backend, einer Datenbank, Authentifizierung, CMS, Kommentarsystem oder dynamischem Serververhalten fragt.
Eingaben
Verwenden, was der Nutzer bereitstellt. Nicht blockieren, wenn einige Details fehlen.
Nützliche Eingaben umfassen:
- Themenrichtung: privates Code-Archiv, Recherche-Log-Dashboard, digitaler Garten, Bento-Portfolio, Feldnotizbuch, persönliches Betriebssystem usw.
- Nutzerprofil: Name, Kurzbio, Rolle, Standort, soziale Links, Avatar, Lebenslauf, Veröffentlichungen, Projekte.
- Seitenanforderungen: Startseite, Über mich, Blog, Projekte, Notizen, Veröffentlichungen, Kontakt.
- Beispielinhalte: 1-3 Beiträge, Projektbeschreibungen, Markdown-Schnipsel, ältere HTML-Seiten.
- Vorhandener Site-Ordner: aktuelle HTML/CSS/JS-Dateien zum Erhalten oder Refaktorieren.
- Lockere Referenzen: v0, Figma, GitHub-Themes, Framework-Vorlagen, Screenshots oder Stimmungsreferenzen.
Referenzregel
Referenzen können aus jedem Stack stammen. Sie als visuelle und strukturelle Referenzen behandeln, nicht als Implementierungsentscheidungen, es sei denn, der Nutzer fragt explizit nach der Verwendung dieses Frameworks.
Für eine reine statische Website Referenzen wie folgt übersetzen:
- React-, Next- oder Astro-Komponenten -> wiederholte HTML-Abschnitte mit wiederverwendbaren CSS-Klassen.
- Tailwind-Dienstprogrammklassen -> normale CSS-Regeln in
assets/style.css. - Framework-Routen -> verlinkte
.html-Dateien. - Inhaltskollektionen oder CMS-Daten -> statische HTML-Listen oder kleine JSON-Dateien.
- Thema-Konfiguration -> CSS-Custom-Properties.
- Einfache Interaktionen -> Vanilla-JavaScript nur wenn nützlich.
Wenn der Nutzer eine bestimmte Website originalgetreu nachbilden möchte, an copy-website-style übergeben, anstatt sie als lockere Referenz zu behandeln.
Standard-Seitenstruktur
Für eine neue Website diese Struktur bevorzugen, es sei denn, der Nutzer wünscht etwas anderes:
site/
index.html
EDITING.md
about.html
blog.html
projects.html
posts/
first-post.html
assets/
style.css
script.js
images/
data/
posts.json
profile.json
Bei einer bestehenden Website die aktuelle Struktur des Nutzers beibehalten, wenn praktikabel. Keine großen Teile der Website umbenennen oder neu organisieren, es sei denn, es verbessert die angeforderte Arbeit deutlich.
Seitenerwartungen
Nur die Seiten erstellen, die für die Anfrage des Nutzers benötigt werden. Für einen vollständigen persönlichen Website-Starter umfassen:
- Startseite: Identität, kurze Einführung, themenspezifischer Hero-Bereich, aktuelle Beiträge, ausgewählte Projekte.
- Über mich: Bio, Interessen, Fähigkeiten, Kontakt, soziale Links, optionaler Lebenslauf/Veröffentlichungen.
- Blog-Index: Beitragsliste mit Titel, Datum, Tags und Zusammenfassung.
- Beitragsseite: lesbares Artikel-Layout mit Titel, Datum, Tags, Inhalt und Navigation zurück zum Blog-Index.
- Projekte: Projektkarten oder -zeilen mit Beschreibung, Stack, Links und Ergebnis.
Den ersten Bildschirm nützlich halten. Keine Marketing-Landingpage erstellen, wenn der Nutzer nach einer persönlichen Website oder einem Blog gefragt hat.
Für einen vollständigen persönlichen Website- oder Blog-Starter nicht bei einer einzigen Startseite aufhören. Funktionierende repräsentative Seitentypen erstellen, auch wenn der Inhalt nur Platzhalter ist:
- Mindestens eine Artikel-/Detailseite für einen Blog.
- Eine Listen- oder Archivseite, wenn Beiträge, Notizen, Projekte oder Veröffentlichungen Teil der Website sind.
- Eine Profil-/Über-mich-Seite, wenn die Startseite auf Identität oder Hintergrunddetails verweist.
- Jede spezielle Seite, die durch das gewählte Konzept impliziert wird, wie Notizen, Links, Garden, Now, Uses, Veröffentlichungen oder Experimente.
Für große zukünftige Inhaltskollektionen die Struktur und ein paar repräsentative Platzhaltereinträge erstellen, anstatt ein vollständiges Archiv zu erfinden.
Pfadkompatibilitätsregel
Generierte statische Websites müssen funktionieren, wenn der Nutzer index.html direkt öffnet, über lokales HTTP bereitgestellt wird und auf gängigen statischen Hosts bereitgestellt wird.
Standardregeln:
- Seitenrelative Pfade für alle site-lokalen Links und Assets verwenden.
- Von Root-Seiten aus CSS/JS/Bilder als
assets/style.css,assets/script.js,assets/images/avatar.pngund Seiten alsabout.htmloderposts/example.htmlverlinken. - Von verschachtelten Seiten wie
posts/example.htmlaus gemeinsame Assets als../assets/style.cssund Root-Seiten als../blog.htmloder../index.htmlverlinken. - Keine root-absoluten site-lokalen Pfade wie
/assets/style.css,/assets/script.js,/posts/example.html,/data/posts.json,/images/foo.pngoder/verwenden, es sei denn, der Nutzer akzeptiert explizit nur Server-Root-Verhalten. - Dieselbe Regel auf CSS
url(...), Favicons, Open Graph-Bilder, Titelbilder, Schriftarten, KaTeX/Math-Vendor-Assets, RSS/Sitemap-Links und JavaScript-generierte URLs anwenden. - Beim Verschieben oder Hinzufügen einer Seite Pfade basierend auf der Ordner-Tiefe dieser Seite neu berechnen, anstatt Links von einer Root-Seite zu kopieren.
Server-only-Annahmen vermeiden:
- Sich nicht auf
fetch("data/posts.json")oder andere lokale Dateiabrufe für die Kernnavigation, Beitragslisten oder Startseiteninhalte verlassen, wenn die direkte Öffnungsvorschau Teil des Versprechens ist. - Wenn wiederholte Daten nützlich sind, entweder wesentliche Inhalte direkt in HTML rendern oder Daten in einem lokalen JavaScript-Objekt speichern, das mit einem relativen
<script src="assets/script.js">geladen wird. - Optionale Erweiterungen dürfen Datendateien nur dann verwenden, wenn die Seite auch ohne diesen Abruf noch korrekt liest und navigiert.
Stilregeln
Das ausgewählte Thema die visuelle Sprache leiten lassen, aber die Website lesbar und wartbar halten.
- Site-weites Styling in
assets/style.cssplatzieren. - CSS-Custom-Properties für Farben, Abstände, Rahmen und Schriftauswahl verwenden.
- Semantisches HTML wo möglich verwenden:
header,nav,main,article,section,footer. - Responsive Layout-Regeln verwenden, damit Seiten auf Mobilgeräten und Desktops funktionieren.
- Artikelseiten ruhiger als die Startseite gestalten, wenn das Thema visuell intensiv ist.
- Systemschriften bevorzugen, es sei denn, der Nutzer fragt nach einer bestimmten Schriftart oder das Thema benötigt eine.
- Nicht auf entfernte Assets angewiesen sein, es sei denn, der Nutzer stellt sie bereit oder sie sind klar akzeptabel.
- Dekorative Effekte das Lesen, die Navigation oder die Zugänglichkeit nicht blockieren lassen.
Interaktionsregeln
Vanilla-JavaScript nur verwenden, wenn es einen klaren Mehrwert bietet.
Gute Verwendungen:
- Mobile Navigation umschalten.
- Theme umschalten.
- Leichtgewichtige Tag- oder Beitragsfilterung.
- Kleine progressive Effekte, die das Kernlesen nicht beeinträchtigen.
Vermeiden:
- Schwere Animations-Frameworks.
- Canvas-lastige Dekoration, es sei denn, der Nutzer fragt explizit danach.
- Effekte, die einen Dev-Server oder eine Paketinstallation erfordern.
- Kontinuierliches Flackern, aggressives Glitching oder Scrolleffekte, die das Lesen beeinträchtigen.
prefers-reduced-motion für animierte Themes respektieren.
Statische Vereinfachungsregel
Wenn eine lockere Referenz komplexe oder framework-abhängige Funktionen hat, in einfachere statische Äquivalente übersetzen:
- 3D-Globus -> Themenkarte, Status-Panel, Projektkonstellation oder statischer visueller Block.
- Animiertes Bento-Grid -> responsives CSS-Grid mit subtilen Hover-Zuständen.
- Terminal-Simulator -> thematische Navigation und Log-artiger Inhalt, keine gefälschte Befehlszeile, es sei denn nützlich.
- Wissensgraph -> Tags, verwandte Beiträge, Themenindex oder manuell kuratierte Links.
- Dynamische Suche -> einfaches Filter-Eingabefeld, statische Tag-Seiten oder keine Suche für die erste Version.
- CMS-gesteuerte Beiträge ->
posts/*.htmlplusdata/posts.json.
Eine saubere statische Version bevorzugen, die das gewünschte Gefühl des Nutzers einfängt, anstatt eine überladene Kopie der Referenz.
Regel für bestehende Websites
Bei der Änderung einer bestehenden Website:
- Vor der Bearbeitung die aktuelle Dateistruktur inspizieren.
- Nutzerinhalte und nicht verwandte Dateien erhalten.
- Änderungen auf die angeforderten Seiten und Assets beschränken.
- Bestehende visuelle Konventionen wiederverwenden, wenn sie bereits funktionieren.
- Die gesamte Website nicht ersetzen, es sei denn, der Nutzer wünscht ein vollständiges Redesign.
- Wenn die Site bereits
style.cssoderscript.jshat, diese sorgfältig erweitern, anstatt widersprüchliche Duplikate zu erstellen.
Inhaltsregel
Für kleine Mengen an Inhalten statisches HTML direkt schreiben.
Für wiederholte Inhalte wie Beiträge oder Projekte entweder verwenden:
- Statisches wiederholtes HTML, wenn die Liste kurz ist.
- Ein lokales JavaScript-Datenobjekt plus Vanilla-JavaScript-Rendering, wenn es die Wartbarkeit verbessert.
- Eine kleine JSON-Datei nur, wenn die Site für diese Funktion lokales HTTP/statisches Hosting benötigen darf und die Kernseite auch ohne sie funktioniert.
Keine detaillierten persönlichen Fakten erfinden. Platzhalter klar verwenden, wenn Nutzerdaten fehlen.
Platzhalter leicht auffindbar und ersetzbar halten. Wiederholte Inhalte bevorzugt an einem klar benannten Ort wie data/*.json, einem dokumentierten Datenblock in assets/script.js oder einem wiederholten HTML-Abschnitt mit stabilen Klassennamen speichern.
Platzhalter-Only-Text, Demo-Beiträge, Beispielprojekte und Mock-Links klar in den Dateien oder EDITING.md markieren, damit der Nutzer oder ein zukünftiges Modell sie vor der Veröffentlichung ersetzen kann.
Bearbeitungsleitfaden-Regel
Beim Erstellen einer neuen Website oder bei einem materiellen Redesign einer bestehenden EDITING.md im Ausgabeordner bereitstellen.
EDITING.md ist in erster Linie für ein zukünftiges Modell oder einen Agenten, das/die die generierte Site später ändern wird. Kurz aber konkret halten. Erklären:
- Ordnerhierarchie und wofür jede Datei/jeder Ordner ist.
- Dateiformate, die von der Website verwendet werden: HTML, CSS, JS, JSON/Datenblöcke und Bilder.
- Seitenkarte: welche generierte Datei ist Startseite, Über mich/Profil, Blog/Liste, Artikel/Detail, Projekte, Notizen, Links oder andere Seitentypen.
- Gemeinsame Layoutbereiche: Header, Navigation, mobile Navigation, Hauptinhalt, Footer, Sidebars, Overlays oder Themensteuerungen.
- Wo jeder wichtige Startseitenbereich in
index.htmllebt, unter Verwendung nahegelegener Abschnitts-/Klassennamen. - Wo jede Unterseitenvorlage lebt und wie interne Links darauf verweisen.
- Wo wiederholte Inhalte gespeichert sind und ihr erwartetes Objekt-/Markup-Format.
- Wie Site-Titel, Tagline, Avatar/Logo, Navigation, vorgestellte Beiträge, Projektlisten, Linklisten, Bilder, Farben und Themavariablen geändert werden.
- Welcher Inhalt nur Platzhalter ist und vor der Veröffentlichung ersetzt werden sollte.
Kodierungsintegritätsregel
Generierte Quelldateien müssen gültiges UTF-8 sein und in Quellform menschenlesbar, nicht nur in Browser-Screenshots korrekt aussehend.
Für Seiten oder Bearbeitungsleitfäden mit chinesischem, japanischem, koreanischem, akzentuiertem lateinischem Text oder anderen Nicht-ASCII-Inhalten:
<meta charset="utf-8">in HTML-Dateien einschließen.- Dateien als UTF-8 schreiben.
- Quelltext-Lesbarkeit mit einem UTF-8-fähigen Leser vor der endgültigen Auslieferung überprüfen.
…
[abgeschnitten für Übersetzung]