Communitygithub.com

Gyschuaner/von-der-Idee-zur-personal-Website

Verwende diesen Skill, wenn der Benutzer das Aussehen, Layout, die Bewegung oder das Interaktionsgefühl einer bestimmten Website, URL, eines Screenshots oder einer Vorlage mit einfachem HTML, CSS und JavaScript nachbauen, kopieren, klonen, neu mischen oder genau treffen möchte. Er dient dazu, öffentliche Quellen als Recherche zu inspizieren, Originalcode neu zu schreiben, die direkte Wiederverwendung geschützter Assets zu vermeiden und das Ergebnis im Browser zu validieren.

Was ist von-der-Idee-zur-personal-Website?

Dieser Skill ermöglicht es einem KI-Agenten, das visuelle Erscheinungsbild und die Interaktionsmuster einer bestehenden Website originalgetreu als saubere, statische HTML/CSS/JS-Implementierung nachzubilden. Der Fokus liegt auf dem Kopieren von Stil und Verhalten, ohne geschützten Code, Assets, persönliche Identitäten oder Analysedienste zu übernehmen. Stattdessen wird eine eigenständige, wartbare Version erstellt, die über lokale Dateien, einen HTTP-Server oder statisches Hosting funktioniert. Der Skill unterstützt Plattformen wie Claude Code, Codex und Cursor und folgt einer strengen Pipeline: Browser-Erkundung des Originals, Quellcode-Analyse als Recherche, Extraktion des visuellen „Signature Inventory“ (Layout, Animationen, Interaktionen), Ersetzen der ursprünglichen Identität durch Platzhalter- oder Benutzerinhalte, Konvertierung von Framework-Routen in statische, seitenrelative Pfade und Validierung im echten Browser gegen das Original. Er ist ideal für Situationen, in denen der Benutzer sagt: „Mach es wie diese Website“ und eine hohe Detailtreue bei Layout, Animation, Scroll- und Hover-Effekten erwartet. Der Skill enthält klare Grenzen: Er wird nicht zum Durchsuchen von Themes, zum Erstellen einer originalgetreuen persönlichen Seite ohne Referenz oder zum direkten Kopieren geschützter Inhalte verwendet. Nach der Implementierung wird eine `EDITING.md` mit einer Seitenkarte, Inhaltsorten und vereinfachten Interaktionen erstellt, und der Erfolg wird durch einen Vergleich mit dem Original und einen statischen Prüfprozess sichergestellt.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Website-Stil kopieren

Ziel

Das sichtbare Aussehen, Layout, die Bewegung und das Interaktionsgefühl einer bestimmten Website als saubere statische Implementierung nachbilden.

Dieser Skill ist für "Mach es wie dieses"-Aufgaben. Er ist strenger als ein loser Themenbezug: Die Ausgabe sollte der erkennbaren Komposition und dem Verhalten des Ziels ähneln, dabei aber originelles, wartbares HTML/CSS/JS verwenden.

Kernprinzip:

  • Kopiere den Stil und das Interaktionsmuster.
  • Kopiere standardmäßig keinen geschützten Code, keine Assets, keine persönliche Identität, keine privaten Links und keine Analysedienste.
  • Schreibe eine saubere statische Version neu.
  • Verwende seitenrelative interne Links und Assets, damit das Ergebnis durch direktes Öffnen der Datei, lokales HTTP und statisches Hosting funktioniert.
  • Validiere gegen das Ziel in einem echten Browser.

Vertrag

Eingaben:

  • Ziel-URL, Screenshot, Vorlage, lokale Referenz oder konkrete visuelle/Bewegungsreferenz.
  • Gewünschter Umfang: Startseite, ausgewählte Seiten oder vollständige navigierbare statische Nachbildung.
  • Ausgabeordner, Berechtigungskontext und alle Benutzeridentitäten/Inhalte, die Zielinhalte ersetzen sollen.

Ausgaben:

  • Eine saubere, reine HTML/CSS/JS-statische Nachbildung des erkennbaren Layouts, der Bewegung, des Interaktionsgefühls und der Seitentypen des Ziels.
  • Platzhalter- oder benutzereigene Inhalte anstelle der kopierten Zielidentität.
  • EDITING.md mit Seitenkarte, Inhaltspositionen, vereinfachten Interaktionen und ausgelassenen Routen.
  • Vergleichs- und Validierungszusammenfassung.

Grenzen:

  • Verteile keinen geschützten Code, keine privaten Assets, keine Analysedienste, keine ursprünglichen persönlichen Inhalte oder nicht lizenzierte Medien weiter.
  • Höre nicht bei einer einzigen Startseite auf, wenn der angeforderte Umfang eine navigierbare Website impliziert.
  • Behalte standardmäßig keine root-absoluten Framework-Routen bei; konvertiere sie in statische relative Pfade.
  • Veröffentliche nicht; verwende publish-static-site.

Erfolgskriterium:

  • Die lokale Nachbildung stimmt mit dem signifikanten Layout, der visuellen Sprache und den Kerninteraktionen des Ziels genau genug für die angeforderte Genauigkeit überein.
  • Wichtige Seitentypen existieren und sind verlinkt.
  • Die Zielidentität wurde ersetzt oder explizit erlaubt.
  • review-static-site kann bestehen oder nur akzeptierte Einschränkungen melden.

Wenn das Kriterium fehlschlägt:

  • Überprüfe das Ziel erneut und iteriere bei signifikantem Layout/Bewegung.
  • Verwende personalize-site für Identitätsreste.
  • Verwende review-static-site für strukturelle/Pfad-/Kodierungs-/Browser-Blockaden.

Kurze Pipeline

Befolge diese Pipeline für die Website-Nachbildung:

  1. Erkunde das Ziel in einem Browser.
  2. Kartiere die internen Seiten und anklickbaren Routen des Ziels.
  3. Inspiziere Quellcode und Assets als Recherche.
  4. Extrahiere signifikantes Layout, Bewegung, Interaktionen und visuelle Elemente.
  5. Ersetze die ursprüngliche Identität und persönlichen Inhalte der Website.
  6. Baue die vollständig navigierbare Website mit reinem HTML/CSS/JS neu auf.
  7. Konvertiere Framework-/Root-Routen in statische, seitenrelative Links.
  8. Füge einen Bearbeitungsleitfaden für zukünftige Modell-/Benutzerbearbeitungen hinzu.
  9. Validiere lokal über HTTP in einem echten Browser.
  10. Vergleiche mit dem Ziel und iteriere.
  11. Prüfe auf übrig gebliebenen zielspezifischen Text oder Assets.

Verwende, wenn

Verwende diesen Skill, wenn der Benutzer sagt oder impliziert:

  • Kopiere diesen Website-Stil.
  • Baue diese Seite nach.
  • Klone diese Website.
  • Erstelle eine statische Version dieser Website.
  • Mach es wie diese URL oder dieser Screenshot.
  • Treffe die ursprüngliche Animation, Scroll-, Hover- oder Interaktion.
  • 1:1, hohe Genauigkeit, pixelgenau, gleiches Gefühl, gleiche Bewegung.

Verwende ihn für Referenzen von Websites, v0, Figma, GitHub-Themes, Astro, Hugo, Jekyll, Quartz, Next, React, Tailwind oder anderen frameworkbasierten Vorlagen, wenn der Benutzer eine enge Nachbildung und keine lose Inspiration wünscht.

Nicht verwenden, wenn

Verwende diesen Skill nicht, wenn:

  • Der Benutzer nur nach Themes suchen möchte. Verwende search-blog-theme.
  • Der Benutzer eine originelle persönliche Seite basierend auf einer gewählten Richtung wünscht. Verwende make-personal-site.
  • Der Benutzer eine Inhaltsmigration oder einen Beitragsimport wünscht. Verwende add-blog-posts.
  • Der Benutzer nur Hilfe bei der Bereitstellung benötigt. Verwende publish-static-site.
  • Der Benutzer darum bittet, geschützten Code, private Assets oder persönliche Inhalte von einer Website, die ihm nicht gehört, direkt zu kopieren.
  • Der Benutzer explizit das ursprüngliche Framework und Build-System beibehalten möchte, anstatt eine einfache statische Version zu erstellen.

Eingaben

Verwende, was verfügbar ist:

  • Ziel-URL, Screenshot, Video, Vorlagenlink oder lokale Referenz.
  • Gewünschter Ausgabeordner des Benutzers.
  • Ob das Endergebnis Platzhalterinhalte oder die eigenen Inhalte des Benutzers enthalten soll.
  • Erforderliche Seiten oder Abschnitte.
  • Erwarteter Umfang, falls vom Benutzer angegeben: nur Startseite, ausgewählte Seiten oder vollständig navigierbare Website.
  • Ob der Benutzer Eigentümer des Ziels ist oder die Erlaubnis zur Wiederverwendung von Assets/Code hat.
  • Alle erforderlichen statischen Einschränkungen: kein Build-Schritt, keine externen Abhängigkeiten, nur lokale Bereitstellung usw.

Browser-Erkundungsdurchlauf

Vor der Implementierung das Ziel in einem echten Browser erkunden, wenn eine URL oder interaktive Referenz verfügbar ist.

Verwende ein tatsächlich verfügbares interaktives Browser-Tool als bevorzugte Methode, um das Ziel und die lokale Vorschau zu beobachten. "Verfügbar" bedeutet, dass das Tool in der aktuellen Runde in der Liste der aufrufbaren Tools angezeigt wird und nicht nur in einem Skill, einer Plugin-Liste oder einer Systembeschreibung erwähnt wird. In Codex kann dies das Browser-/In-App-Browser-Plugin sein, wenn der Benutzer oder Client es in die Runde geleitet hat; in anderen Agenten kann es ein gleichwertiger sichtbarer Browser, ein Browser-Use-Tool oder ein DevTools-gestützter Browser sein. Das Ziel ist es, die Seite so zu sehen, wie der Benutzer sie sieht: Viewport, Bewegung, Scrollen, Hover-/Klickverhalten, mobiles Layout, Konsolenzustand und Netzwerkfehler.

Wenn kein interaktives Browser-Tool in der aktuellen Runde verfügbar ist, tue nicht so, als ob der Browserdurchlauf stattgefunden hätte. Wenn die Zielerkundung oder der lokale Vergleich davon abhängt, bitte den Benutzer, das Browser-Tool über die Routing-Methode seines Clients zu aktivieren oder aufzurufen; für Codex kann dies bedeuten, eine Anfrage zu senden, die explizit @browser erwähnt. Wenn der Benutzer nicht umleitet oder der Client kein solches Tool hat, falle auf Playwright, Screenshots, statische Audits oder Quellinspektion zurück und gib die Einschränkung an.

Standardmäßig nicht auf Playwright, Headless-Screenshots oder reine Quellinspektion zurückgreifen, wenn ein interaktives Browser-Tool tatsächlich aufrufbar ist. Screenshots können dokumentieren, was beobachtet wurde, aber sie sind kein Ersatz für einen interaktiven Browserdurchlauf. Playwright nur als Fallback verwenden, wenn kein interaktives Browser-Tool aufrufbar ist, wenn der Benutzer explizit nach Playwright fragt oder wenn ein wiederholbarer, skriptgesteuerter Vergleich speziell benötigt wird.

Verwende Chrome-Automation, wenn die Aufgabe das Chrome-Profil des Benutzers, einen vorhandenen Chrome-Tab, Erweiterungen, authentifizierte Seiten oder Chrome-spezifisches Verhalten benötigt.

Während der Erkundung Folgendes inspizieren:

  • Desktop-Startbildschirm: Zusammensetzung, Maßstab, Abstände, Typografie, Farbe, sichtbare Navigation und primäres visuelles Motiv.
  • Mobiler Startbildschirm: Layoutänderungen, versteckte Navigation, Scrollverhalten und Inhaltspriorität.
  • Öffnungssequenz: Ladezustand, Enthüllungsreihenfolge, Opazitäts-/Skalierungs-/Clip-Änderungen, Verzögerungen und Easing-Gefühl.
  • Scrollverhalten: vertikales vs. horizontales Scrollen, fixierte Bereiche, Einrastpunkte, Trägheit, scroll-verknüpfte Transformationen und Minimap-Änderungen.
  • Zeigerverhalten: Hover-Zustände, Cursor-Details, Drag-Verhalten, zeigerfolgende Elemente und Trefferflächen.
  • Klickverhalten: Navigation, Schalter, Kopierzustände, aktive Zustände, Modale und Übergänge.
  • Tastaturverhalten: Pfeiltasten, Tab-Fokus, Escape-/Eingabetaste, wenn relevant.
  • Interne Seitenkarte: primäre Navigationslinks, Header-/Footer-Links, Karten, die interne Seiten öffnen, Artikel-/Detailseiten, Archiv-/Kategorie-/Such-/Theme-/Einstellungsseiten, Paginierung und Mobile-Menü-Routen.
  • Quellhinweise: DOM-Struktur, CSS-Variablen, Klassennamen, Inline-Stile, geladene Schriftarten, Bild-Assets, gebündelte CSS/JS-Namen und Netzwerkanfragen.
  • Konsolenzustand: sichtbare Laufzeitfehler oder Warnungen, die das Verhalten beeinflussen können.

Erfasse oder notiere im Gedächtnis genügend Beweise, um die Implementierung zu leiten. Lege dem Benutzer kein langes Erkundungsprotokoll vor, es sei denn, er fragt danach; verwende es, um das Signaturinventar und den Implementierungsplan zu erstellen.

Quellinspektionsregel

Für öffentliche Websites können Seitenquellcode, gebündeltes CSS/JS, netzwerkgeladene Assets und die DOM-Struktur inspiziert werden, um Layout, Breakpoints, CSS-Variablen, Animations-Timing, Scrollverhalten und Interaktionslogik zu verstehen.

Verwende die inspizierte Quelle als Forschungsmaterial, nicht als standardmäßig auslieferbaren Code.

Kopiere, verteile oder behalte keinen Code, keine Bilder, Schriftarten, persönlichen Inhalte, privaten Links, Analysedienste oder gebündelten Assets einer anderen Website direkt, es sei denn, eines der folgenden trifft zu:

  • Der Benutzer besitzt die Website.
  • Die Quelle oder das Asset ist eindeutig Open Source mit einer kompatiblen Lizenz.
  • Der Benutzer bestätigt, dass er die Erlaubnis zur Wiederverwendung hat.

Schreibe für normale Nachbildungsarbeiten eine saubere, wartbare, reine HTML/CSS/JS-Version, die das sichtbare Verhalten und die Designsprache erfasst. Wenn ein inspiziertes Implementierungsdetail wichtig ist, übersetze die Idee in originellen Code.

Genauigkeits-Workflow

Behandle diese Schritte als erforderliche interne Arbeit für eine ernsthafte Nachbildung:

  1. Führe den Browser-Erkundungsdurchlauf durch, wenn möglich.
  2. Erstelle eine Zielseitenkarte aus der sichtbaren Navigation und wichtigen internen Links.
  3. Inspiziere die Zielquelle und das DOM auf Implementierungshinweise.
  4. Identifiziere das signifikante Layout, die signifikante Bewegung, die signifikanten Interaktionen und die signifikanten visuellen Details des Ziels.
  5. Implementiere die gemeinsame Hülle, dann die verlinkten internen Seiten.
  6. Zeige die lokale statische Version über HTTP vor.
  7. Vergleiche das lokale Ergebnis mit dem Ziel in ähnlichen Browser-Viewports.
  8. Iteriere, bis das Ergebnis dem Gefühl des Ziels genau genug für die Anfrage des Benutzers entspricht.
  9. Melde alle verbleibenden wesentlichen Unterschiede.

Höre nicht auf, nachdem die HTML-Struktur ähnlich ist, wenn das Ziel bewegungsorientiert ist.

Vollständige Website-Umfang-Regel

Standardmäßig das Ziel als navigierbare statische Website nachbilden, nicht nur als einzelne Startseite.

Es sei denn, der Benutzer bittet explizit um "nur Startseite", erstelle statische Seiten für die wichtigen internen Routen des Ziels:

  • Primäre Navigationsseiten.
  • Artikel-/Detailseiten, die von der Startseite oder primären Listen verlinkt sind.
  • Archiv-, Kategorie-, Tag-, Link-, Theme-, Vorschau-, Einstellungs- oder Suchseiten, wenn sie Teil der sichtbaren Erfahrung sind.
  • Mobile-Menü-Ziele.
  • Paginierungs- oder Listenseiten, wenn sie definieren, wie die Website durchsucht wird.

Spiegele nicht jeden echten Inhaltseintrag für große Websites wider. Baue die Seitenstruktur und Seitentypen mit Platzhalterinhalten nach:

  • Einen oder wenige repräsentative Artikel-/Detailseiten.
  • Repräsentative Archiv-/Kategorie-/Listenseiten.
  • Platzhaltereinträge, die Paginierung, Filterung, Suche, Karten und Seitenleistenverhalten demonstrieren.
  • Funktionierende interne Links zwischen den generierten statischen Seiten.

Zeichne die generierte Seitenkarte in EDITING.md auf. Wenn Zielrouten absichtlich ausgelassen werden, erkläre warum und wie sie hinzugefügt werden können.

Signaturinventar

Erstelle vor dem Codieren ein internes Inventar:

  • Signaturlayout: Seitenstruktur, Zusammensetzung, Maßstab, Abstände, Navigation, Breakpoints, wiederholte Motive und ungewöhnliche Layoutmechaniken.
  • Signaturbewegung: Öffnungsanimation, Enthüllungseffekte, Scrollverhalten, Easing, federähnliche Bewegung, Hover-Zustände, Übergänge, Ladezustände.
  • Signaturinteraktionen: Radverhalten, Tastaturverhalten, Klickzustände, Kopierzustände, aktive Navigation, Drag-/Scroll-Gesten, mobile Änderungen.
  • Signaturvisuelles: Farben, Typografie-Gefühl, Kontrast, Rahmen, Schatten, Maskierung, Mischmodi, Formen, Illustrationen, Hintergrundbehandlung.

Baue diese Signaturstücke nach, bevor du sekundäre Inhalte füllst.

Framework- und Bewegungsübersetzungsregel

Das Ziel kann jeden Stack verwenden. Übersetze das sichtbare Verhalten in statische Dateien, es sei denn, der Benutzer bittet explizit um etwas anderes.

Häufige Übersetzungen:

  • React-, Next- oder Astro-Komponenten -> wiederholte HTML-Abschnitte mit wiederverwendbaren CSS-Klassen.
  • Tailwind Utility-Klassen -> normale CSS-Regeln.
  • Framework-Routen -> verlinkte .html-Dateien.
  • Inhaltssammlungen oder CMS-Daten -> statische HTML-Listen oder kleine JSON-Dateien.
  • Theme-Konfiguration -> CSS-Custom-Properties.
  • Framer Motion Spring -> Vanilla-JavaScript-spring-loop, requestAnimationFrame oder sorgfältig abgestimmtes CSS-Easing.
  • scrollX / scrollY-Transformationen -> Scroll-Fortschritt, abgebildet auf CSS-Custom-Properties und Transformationen.
  • Clip-Enthüllung -> overflow: hidden plus translateY, clip-path oder Maskenanimation.
  • Skalierungs-Enthüllung -> transform: scale(...) mit transform-origin und Easing.
  • Layout-Bewegung -> transform- und opacity-Übergänge, keine layout-zerstörenden Breiten-/Höhenänderungen.
  • Scroll-verknüpfte horizontale Leinwand -> Wheel-Listener plus horizontales Scrollen, Einrastpunkte, aktive Panel-Erkennung und optionales Trägheits-Easing.
  • Minimap-Tracker -> aktiver Zustand plus Transform-/Opacity-Synchronisation mit der Scrollposition.
  • Copy-to-Clipboard-Animation -> Zwei-Zustands-Textwechsel mit translate/opacity-Übergang.
  • Cursor-/Fadenkreuzdetails -> fixiertes Element oder zeigerfolgende Transformation, wenn zentral für die Referenz.
  • Überblendungseffekte -> CSS mix-blend-mode, Masken oder ein vereinfachter statischer Kontrast bei Bedarf.

Respektiere prefers-reduced-motion, entferne aber die Signaturbewegung nicht vollständig, es sei denn, die reduzierte Bewegung ist aktiv.

Statische Pfadkompatibilitätsregel

Die Zielseite kann Server-Root-Routen wie /assets/..., /posts/..., /blog oder Framework-Routing verwenden. Die nachgebildete statische Ausgabe sollte diese Root-absoluten Pfade standardmäßig nicht beibehalten.

Standardregeln:

  • Verwende seitenrelative Pfade für jedes lokale Asset und jeden internen Link.
  • Von Startseiten aus verwende assets/style.css, assets/script.js, posts/example.html und archive/index.html.
  • Von verschachtelten Seiten aus verwende die korrekte Tiefe wie ../assets/style.css, ../index.html oder geschwister-relative Links.
  • Konvertiere Zielrouten wie /posts/foo, /tags/bar oder /projects in generierte statische Pfade wie posts/foo.html, tags/bar.html, projects.html oder projects/index.html entsprechend der Ausgabestruktur.
  • Behalte /assets/..., /posts/..., /data/..., /images/... oder / für die interne Navigation nicht bei, es sei denn, der Benutzer akzeptiert explizit das Server-Root-Verhalten.
  • Wende dies auf HTML-Attribute, CSS url(...), Favicons, Titelbilder, Schriftarten, Mathe-/Vendor-Assets, JavaScript-generierte Karten/Suchergebnisse und kopierte Routendaten an.

Vermeide es, den Benutzer zu bitten, die resultierenden Dateien auf einem Server mit statischen Weiterleitungsregeln zu hosten, um Framework-Routen nachzuahmen. Der Ausgabeordner sollte direkt über Datei-Öffnen oder jeden einfachen statischen HTTP-Server navigierbar sein.

Weiterleitungs- und 404-Regel

/-Routen: Implementiere /some/path/ entweder als some/path/index.html oder some/path.html. Wähle konsistent basierend auf der Ordnerstruktur oder der Benutzerkonvention. Dokumentiere die Wahl in EDITING.md.

Weiterleitungen: Der Ausgabeordner sollte keine serverseitigen Weiterleitungen oder Rewrite-Regeln erfordern. Wenn der Benutzer eine saubere Route wie /some/path wünscht, behandle dies als some/path.html im Ausgabeordner.

404-Seite: Erstelle immer eine 404.html auf der obersten Ebene des Ausgabeordners, wenn die Seite des Ziels eine benutzerdefinierte 404-Seite hat oder der Ausgabeordner mehr als eine Seite enthält. "'Scuse me" oder "This page is not found" effektvoll darstellen; kopiere nicht den Stil der Ziel-404-Seite, es sei denn, sie ist Teil des Signaturerlebnisses.

Ausgabeanforderungen

Ausgabeordnerstruktur

Erstelle alle Dateien im angegebenen Ausgabeordner, es sei denn, der Benutzer gibt einen anderen Pfad an. Strukturiere den Ausgabeordner so, dass er direkt navigierbar ist:

  • index.html
  • assets/ (CSS-, JS-, Bild- und Schriftarten-Unterordner).
  • articles/ (oder gleichwertig) mit article-1.html und verschachtelten index.html-Dateien nach Bedarf.
  • tags/ mit tag-name.html.
  • archive/ mit index.html.
  • theme/, settings/ und andere sichtbare Ziele, wenn im Ziel vorhanden.
  • 404.html.

Forme Routen wie /articles/why-this-matters in articles/why-this-matters.html. Verwende /index.html für die Startseite. Dokumentiere die Struktur in EDITING.md.

EDITING.md

Füge EDITING.md als lesbare Referenz für Benutzer und nachfolgende Modellbearbeitungen bei. Dazu gehören:

  • Generierte Seitenkarte mit Pfaden und Seitentypen.
  • Wo primäre Inhaltsblöcke lokalisiert sind: Heldenbereich, vorgestellte Beiträge, Kartenlisten, Seitenleisten, Archive, Tags, Suchergebnisse.
  • Welche Zielelemente oder Routen nicht enthalten sind und warum.
  • Wie ein Betreuer neue Inhalte hinzufügen, bestehende ersetzen oder das Layout anpassen würde.
  • Alle statischen Pfadkonventionen, die vom Üblichen abweichen.

"'Scuse me" (404-Seite)

Verwende wann immer möglich einen einfachen, charmanten und effektvollen "'Scuse me"-Ton. Beispiel: "'Scuse me — we couldn't find that page." Füge einen Link zurück zur Startseite hinzu. Verwende nicht den 404-Stil des Ziels, es sei denn, er ist Teil des Signaturerlebnisses.

Bereitstellungshinweis

Nachdem die Implementierung abgeschlossen und validiert wurde, kann publish-static-site verwendet werden, wenn der Skill in der aktuellen Runde verfügbar ist und der Benutzer eine Veröffentlichung wünscht. Füge dies nicht automatisch hinzu; warte auf eine explizite Anfrage oder Bestätigung des Benutzers.

Arbeitsbeispiele

Beispiel 1: Minimalistisches persönliches Blog mit Scroll-Enthüllung

Ziel: Ein persönliches Blog auf Quartz mit einer vertikalen Zeitleiste, Scroll-Enthüllung der Beitragskarten und einer festen Inhaltsnavigation.

Workflow:

  1. Browser-Erkundung: Desktop- und Mobillayout beobachtet.
  2. Quellinspektion: DOM für Zeitleiste und Scroll-Listener überprüft; CSS-Variablen für das Farbschema notiert.
  3. Signaturinventar:
    • Layout: Zeitleiste + Beitragskarten im Raster.
    • Bewegung: translateY + Opazitäts-Enthüllung; Scroll-verknüpfte Navigation.
    • Interaktionen: Klick zum Öffnen des Beitrags; aktive Navigationshervorhebung beim Scrollen.
  4. Implementiert: index.html mit assets/style.css und assets/script.js für die Scroll-Enthüllung.
  5. Erstellt: posts/post-1.html, posts/post-2.html, tags/tech.html, archive/index.html.
  6. Konvertierte absolute Routen in relative Pfade.
  7. EDITING.md mit dem Schema hinzugefügt.
  8. Lokal über HTTP vorgezeigt; gegen das Ziel in ähnlichen Viewports validiert.
  9. Meldung: Geringfügige Schriftartabweichung (Google Fonts nicht in der statischen Version enthalten) als Einschränkung in der Zusammenfassung vermerkt.

Beispiel 2: Spielstudio-Portfolio mit Canvas-Effekten

Ziel: Eine Next.js-Website eines Spielstudios mit WebGL- oder Canvas-Schleife im Hintergrund, festem Header, verschlankten horizontalen Bildlaufbereichen und Hover-Detailkarten.

Workflow:

  1. Browser-Erkundung: Canvas vollbild, horizontales Scrollen im Portfolioabschnitt, Hover-Karten mit Skalierung und Klick.
  2. Quellinspektion: Canvas-Schleifencode notiert; netzwerkgeladene Sprite-Assets notiert.
  3. Signaturinventar:
    • Layout: Vollbild-Canvas + feste UI-Überlagerung.
    • Bewegung: Parallax-Hintergrund; horizontale Scroll-Snap-Abschnitte; Karten-Hover: Skalierung + Grenzrahmen.
    • Interaktionen: Scrollrad für horizontalen Abschnitt; Klick zum Öffnen von Spielkarten.
  4. Obergrenze: Canvas-Schleife vereinfacht zu CSS/JS-animiertem Partikelmuster (originelle Implementierung).
  5. Implementiert:
    • index.html mit Canvas-Ersatz mithilfe von requestAnimationFrame + Leinwand.
    • assets/script.js für horizontales Scroll-Snap und Hover-Effekte.
    • Platzhalter-Assets: Ersetzte Sprite-Assets durch CSS-Gradienten-Karten.
  6. EDITING.md mit Canvas-Anmerkungen und Asset-Referenzen hinzugefügt.
  7. Lokal validiert. Unterschiede: Canvas-Effekt weniger komplex als das Original; als Einschränkung vermerkt; Benutzer stimmt zu.
  8. Bereitgestellt mit publish-static-site auf Anfrage des Benutzers.

Beispiel 3: Gemeinnützige Organisation mit Dark-Mode-Inhaltsarchiv

Ziel: Eine Astro-basierte Website einer gemeinnützigen Organisation mit einem großen Inhaltsarchiv, Dark-Mode-Umschalter, Seitensuche und Artikelseiten mit eingebetteten Medien.

Workflow:

  1. Browser-Erkundung: Startseite mit Heldenbereich + vorgestellte Beiträge; Archivseite mit Filterung; Suche mit Sofortergebnissen; Dark-Mode-Umschaltung.
  2. Quellinspektion: Astro-Inhaltssammlungen als JSON notiert; Tailwind in reines CSS übersetzt; Suchlogik notiert.
  3. Signaturinventar:
    • Layout: Heldenbereich, Kartenraster, Seitenleiste mit Tags.
    • Bewegung: Seitliche Navigations-Enthüllung auf Mobilgeräten; Karten-Hover mit Grenzrahmen; Dark-Mode-übergänge.
    • Interaktionen: Dark-Mode-Umschalter mit localStorage-Persistenz; clientseitiger Suchfilter; Tag-Filterung.
  4. Implementiert:
    • Startseite, Archiv, Artikelvorlage, Suche, Dark-Mode-Umschalter.
    • Generierte statische JSON-Liste von Beiträgen für die Suche.
    • assets/script.js mit Dark-Mode-Logik und clientseitiger Suche.
    • Konvertierte Astro-Inhaltssammlungen in statische HTML + JSON für die Suche.
  5. EDITING.md mit Seitenkarte und Dark-Mode-Variablen hinzugefügt.
  6. Lokal vorgezeigt; Dark-Mode-Funktionalität bestätigt; Tag-Filterung im Vergleich zum Ziel validiert. Gemeldete Einschränkung: clientseitige Suche weniger umfangreich (keine Fuzzy-Suche).
  7. Bereitgestellt auf Anfrage des Benutzers.

Beispiel 4: Prompt-Engineering-Referenz-Website (proprietär)

Ziel: Eine interne React-basierte Prompt-Engineering-Referenz-Website mit einem linken Inhaltsverzeichnis, ausklappbaren Abschnitten, Syntaxhervorhebung für Prompt-Snippets und einer dedizierten „Vergleichen“-Ansicht nebeneinander.

Hinweis: Die Website gehört nicht dem Benutzer und der Quellcode ist nicht öffentlich oder ohne Lizenz. Der Benutzer möchte eine ähnliche statische Referenzseite für ihr eigenes Prompt-Engineering-Framework erstellen, die die Struktur und das Verhalten des Ziels nachahmt, jedoch mit ihren eigenen Inhalten.

Workflow:

  1. Zielerkundung: Browser-Erkundung der Referenzwebsite des Kunden (mit Genehmigung).
  2. Signaturinventar:
    • Layout: Linke Seitenleiste (Inhaltsverzeichnis) + Hauptinhaltsbereich.
    • Bewegung: Ausklappbare Abschnitte; Highlight beim Scrollen; Hover auf Syntaxblöcken.
    • Interaktionen: Ausklappbare Toggle; Scrollen ändert aktives Inhaltsverzeichniselement; Klick auf Syntaxblock kopiert; nebeneinander-Vergleichsmodus.
  3. Implementiert:
    • index.html mit linkem Inhaltsverzeichnis + Hauptbereich.
    • toc-manager.js für ausklappbare Abschnitte und Scroll-Positionserkennung.
    • syntax-highlight.js für Prompt-Blöcke mit Kopierschaltfläche und nebeneinander-Vergleichsmodus.
    • Placeholder-Prompt-Inhalte durch benutzereigene Prompt-Inhalte ersetzt.
  4. EDITING.md mit Seitenkarte, ausklappbaren Gruppen, Syntaxblock-Struktur und Vergleichsmodus-Toggle hinzugefügt.
  5. Lokal vorgezeigt. Syntaktische Hervorhebung und Vergleichsmodus validiert. Gemeldete Einschränkung: Hervorhebung weniger umfassend als das Original.

Übersetzungshinweise

Diese Regeln gelten für Code-zu-Code-Optimierung, wenn der Quellcode oder die Architektur des Ziels inspiziert werden.

1. DOM-zu-HTML-Übersetzung

  • IDs: Behalte logische IDs bei, falls vorhanden, aber gib ihnen bedeutungsvolle Namen (z. B. main-nav). Entferne Framework-spezifische Präfixe/Suffixe.
  • Klassen: Extrahiere semantische Muster aus Tailwind, CSS-Modulen oder CSS-in-JS. Übersetze in normalen CSS-Klassenselektoren.
  • Semantisches HTML: Verwende <nav>, <main>, <article>, <section>, <header>, <footer> Semantik. Verwende <div> und <span> nur für reine Layout-/Stilelemente.
  • Formulare und Interaktivität: Verwende entweder HTML-Formularverhalten oder JavaScript addEventListener. Verlasse dich nicht auf Framework-Ereignissysteme.

2. CSS-Übersetzung

  • Werte: Kopiere signifikante Farben, Abstände, Schriftstärken und Layoutparameter direkt, aber als eigenständige Regeln. Füge sie nicht als Tailwind-Klasse wieder ein.
  • Variablen: Verwende :root-CSS-Custom-Properties für Farben, Abstände, Schriftarten und jede Variable, die wiederverwendet oder in Animationseinheiten referenziert wird.
  • Typografie: Wenn die Zielseite Google Fonts oder @font-face verwendet, schließe entweder den externen @import ein oder ermutige den Benutzer, die Schriftarten herunterzuladen und lokal zu referenzieren. Dokumentiere die Schriftartenentscheidung in EDITING.md.
  • Bilder: Ersetze Inhaltsbilder durch Platzhalter wie https://placehold.co/WIDTHxHEIGHT?text=Image+Description oder benutzereigene Bilder. Beziehe Stilbilder und Logos nicht ein, es sei denn, sie sind lizenzfrei.
  • Umbrüche: Verwende --min-width und clamp(), um den nativen Rahmen des Mediums zu respektieren. Füge Medienabfragen für mobile Viewport-Breiten hinzu.
  • Animation: Verwende CSS @keyframes und transition für Bewegung. Verwende transform und opacity für die Leistung.

3. JavaScript-Übersetzung

  • Zustand: Verwende querySelector, classList.toggle, addEventListener und einfache Callback-Funktionen. Verwende keine externen Zustandsbibliotheken.
  • Frameworks: Verwende kein React, Vue, Svelte usw. Reines DOM-Management.
  • Ereignisse: Hänge click, scroll, wheel, mouseenter, mouseleave, keydown, focus, blur direkt mit addEventListener an. Verwende für die Ereignisverwaltung keine synthetischen Ereignisse.
  • HTTP: Verwende fetch / XMLHttpRequest für externe API-Aufrufe, aber beziehe keine API-Schlüssel des Ziels oder private Endpunkte mit ein. Cookie-basierte Sitzungen sind nicht erlaubt.
  • Canvas: Verwende requestAnimationFrame, CanvasRenderingContext2D und einfache Zeichenlogik. Verwende keine WebGL, es sei denn, es ist für das Signaturerlebnis absolut erforderlich.
  • Scrollgesteuerte Logik: Verwende den scroll-Ereignis-Listener auf dem Fenster oder Container, der den Fortschritt in CSS-Custom-Properties umwandelt. Verwende keine Intersection Observer, es sei denn, sie sind für die Leistung erforderlich.
  • Timer: Verwende setTimeout / setInterval / requestAnimationFrame. Verwende keine abstrakten Timer-Wrapper.

Validierung

Vor dem Abschluss validiere gegen den Signaturstil des Ziels in einem echten Browser.

Browser-Validierung

  • Öffne die lokale statische Seite und die Zielseite in ähnlichen Viewports. Vergleiche: Desktop- und mobile Layout-Komposition, primäre Animation und Enthüllungssequenz, Scroll-Interaktionsgefühl, Hover-Zustände und Klickverhalten.
  • Auf der lokalen Seite: Verwende die Entwicklertools des Browsers, um responsive Layouts zu emulieren, die Netztabulatur, um 404-Fehler zu erkennen, und die Konsolentabulatur, um JavaScript-Fehler zu erkennen.
  • Wenn eine Diskrepanz festgestellt wird: Iteriere auf dem bestimmten Signaturstück. Überprüfe EDITING.md, um zu sehen, ob es sich um eine dokumentierte Einschränkung handelt. Wenn nicht, behebe es.

Statische Prüfung mit review-static-site

Wenn review-static-site im aktuellen Skill-Kontext aufrufbar ist, führe es als letzten Prüfschritt aus, bevor du die Arbeit als abgeschlossen meldest. Dies ist der Standardweg, um die statische Korrektheit zu überprüfen.

Wenn review-static-site in dieser Runde nicht aufrufbar ist, führe die folgende manuelle Prüfung durch und melde:

  • Pfadintegrität: Alle Seiten-internen Links sind relativ und funktionieren; keine /-Routen für interne Ziele; keine defekten Assets (CSS, JS, Bilder, Schriftarten).
  • Kodierung: UTF-8 <meta charset="UTF-8"> ist auf jeder HTML-Seite vorhanden.
  • Konsole: Keine JavaScript-Fehler der Stufe "error" außer solchen, die von Analysediensten Dritter oder offensichtlich dokumentierten Einschränkungen stammen.
  • Dark/Light-Mode: Wenn implementiert, schalte und bestätige, dass die Änderungen beibehalten werden, wenn der Modus umgeschaltet oder die Seite neu geladen wird.
  • Mobile Darstellung: Teste mit einem mobilen Viewport (375px, 390px, 414px).
  • Statisch: Keine Build-Schritte erforderlich; funktioniert bei Datei-Öffnen (file://) oder lokalem HTTP; keine nicht statischen Abhängigkeiten.

Wenn eines dieser Elemente fehlschlägt:

  • Behebe es, wenn möglich.
  • Wenn es nicht innerhalb des statischen Rahmens behoben werden kann, dokumentiere die Einschränkung in der Ausgabe und erkläre dem Benutzer, warum.

Urheberrechts- und Lizenzhinweis

Am Ende der Implementierungszusammenfassung füge einen Standard-Urheberrechts- und Lizenzhinweis ein, der den Benutzer an die Bedingungen der Erstellung erinnert. Beispiel:


Keine Bestätigung oder Verbindung zum ursprünglichen Website-Eigentümer. Diese Implementierung ist eine unabhängige statische Nachbildung, die für den persönlichen Gebrauch des Benutzers auf der Grundlage öffentlich beobachteter Designmuster erstellt wurde. Keine geschützten Inhalte oder Assets des Originals sind enthalten. Der Benutzer ist dafür verantwortlich, dass alle in diese Nachbildung eingefügten Inhalte oder Assets ordnungsgemäß lizenziert sind.


Wenn der Benutzer der Eigentümer der ursprünglichen Website ist, passe den Hinweis entsprechend an.

Individual skills in this repo

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

Gyschuaner/from-idea-to-personal-site

Use this skill to add, import, or migrate one or more blog posts, notes, essays, articles, Markdown files, Word documents, or rich-content writing folders into an existing static personal website or blog while preserving the site's current article style, content structure, navigation, indexes, archives, tags, assets, math, links, tables, code blocks, embeds, and homepage entry points. Use it for pasted posts, local Markdown files, Obsidian notes, .docx drafts, old static HTML posts, exported blog content, or small-to-medium batches of posts after a site has already been created.

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 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