Communitygithub.com

Personal-Site Greenfield — Ein-Prompt-GSAP-Portfolio

Deploybares Personal-Portfolio aus einem Prompt: Vanilla HTML/CSS/JS + GSAP, null Build, 5 Themes, 12 Font-Paare, 16 Anti-AI-Slop-Regeln, 8+ Motion-Muster. index.html öffnen — läuft.

Was ist Personal-Site Greenfield — Ein-Prompt-GSAP-Portfolio?

Personal websites Schritt 1 (Scaffold): Mort1d portfolio-genesis. Ein Prompt → komplettes Vanilla-Personal-Site.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Mort1d/portfolio-site/tree/HEAD/skill/portfolio-genesis

In Ihrer bevorzugten KI fragen

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

Dokumentation

Portfolio Genesis

Portfolio-Generator mit einem einzigen Prompt. Erstellt vollständige, bereitstellbare Websites mit professionellen GSAP-Animationen, responsive Design und einer unverwechselbaren Ästhetik, die handgemacht wirkt – nicht KI-generiert. Der Benutzer öffnet index.html im Browser und sieht ein Portfolio in Produktionsqualität.

Philosophie

  • Jedes Portfolio erzählt eine Geschichte. Das Design IST das erste Projekt im Portfolio.
  • Anti-Template: Keine zwei generierten Seiten sollen gleich aussehen. Das Thema wird bestimmt durch das Feld, die Persönlichkeit und den Ton des Benutzers.
  • "Öffne index.html und sag WOW" – kein npm, keine Build-Schritte, sofortige Befriedigung.
  • Einschränkung = Freiheit: Vanilla HTML/CSS/JS + GSAP erzwingt kreatives CSS, das sich handgemacht anfühlt.
  • Ein Portfolio mit 3 gut präsentierten Projekten schlägt 20 generische Karten. Qualität vor Quantität.
  • Das Scroll-Erlebnis IST das Portfolio. Jedes gescrollte Pixel sollte sich beabsichtigt anfühlen.

Prozess

Schritt 1: Aufnahme

Aus dem Benutzer-Prompt extrahieren:

  • Identität: Name, Handle/Alias, Rolle/Titel
  • Bio: 1–3 Sätze (aus dem Kontext synthetisieren, falls nicht angegeben)
  • Projekte: Titel, Beschreibung, Tags, Links, Deal-Beträge, Rolle
  • Soziale Medien: X, Discord, Telegram, GitHub, LinkedIn, E‑Mail, YouTube (nur angegebene einfügen)
  • Avatar: Dateipfad oder CSS-Verlaufskreis mit Initialen generieren
  • Statistiken: Jahre Erfahrung, Anzahl Projekte, Community-Reichweite, erkundete Tools
  • Ton: professionell | Hacker | kreativ | elegant | verspielt | minimalistisch | cyber

Wenn der Benutzer nur minimale Angaben macht, mit kontextuell relevanten Platzhalterdaten generieren und Einfügepunkte markieren: <!-- CUSTOMIZE: Replace with your Twitter handle -->. Soziale Schaltflächen vollständig weglassen, wenn keine URL angegeben wurde – niemals href="#" rendern.

Schritt 2: Themenauswahl

Den Entscheidungsbaum unten verwenden, um aus 5 Themen auszuwählen. Dann die Themendatei aus references/themes/{theme-name}.md lesen.

Ist der Benutzer in Crypto/Web3/Blockchain?
  JA → "sauber"/"minimalistisch" erwähnt? → mono-minimal
        Sonst → midnight-glass (Standard) oder neon-cyberpunk (wenn "neon"/"cyber" erwähnt)

Ist der Benutzer Designer/Künstler/Kreativer?
  JA → Bevorzugt dunkel? → midnight-glass
        Sonst → warm-organic (Standard) oder paper-brutalist (wenn "editorial"/"print")

Ist der Benutzer Entwickler/Ingenieur?
  JA → midnight-glass (Standard) oder mono-minimal (wenn "sauber"/"minimalistisch")

Ist der Benutzer Student/Anfänger?
  JA → warm-organic (freundlich) oder neon-cyberpunk (wenn jung/energiegeladen)

Ist der Benutzer geschäftlich/professionell?
  JA → mono-minimal (Standard) oder warm-organic (wenn "zugänglich")

Explizite Überschreibungen (höchste Priorität):
  "dunkel" / "glass" → midnight-glass
  "hell" / "sauber" / "papier" → paper-brutalist
  "neon" / "cyber" / "futuristisch" → neon-cyberpunk
  "warm" / "erdig" / "organisch" → warm-organic
  "minimalistisch" / "mono" / "typografie" → mono-minimal

Schritt 3: Dateien generieren

Referenzdateien in dieser Reihenfolge lesen:

  1. references/themes/{ausgewähltes-thema}.md – Farben, Schriftarten, Kartenstil
  2. references/animations/gsap-patterns.md – Animationsrezepte
  3. references/sections/hero-variants.md – Hero-Layout auswählen
  4. references/typography/font-pairings.md – Schriftartauswahl bestätigen

Generiere genau 3 Dateien: index.html, css/style.css, js/main.js

Hero-Layout-Entscheidung

Avatar-Bild vorhanden?
  JA → Zentrierter Avatar (Standard)
        Ausnahme: Designer mit starker Projektvorstellung → Split-Hero
  NEIN → Starker Titel/Slogan? → Vollbild-Typografie
         Sonst → Minimal (Name + Rolle + Scroll-Indikator)

Anzahl der Rollenbeschreibungen:
  1   → Einzelne große Unterüberschrift
  2–3 → Punktgetrennte Unterüberschriftzeile
  4+  → Animierte Rollenrotation via GSAP-Textwechsel

Projektbereich-Entscheidung

Anzahl der Projekte:
  0   → Projekte überspringen. Stattdessen Skills/Tech-Tag-Cloud-Bereich hinzufügen
  1–2 → Große hervorgehobene Karten (volle Breite oder 2-spaltig mit zusätzlichem Abstand)
  3–4 → 2-spaltiges Raster mit gleicher Größe
  5–8 → Bento-Raster (1 große + kleinere Karten)
  9+  → Top 6 mit "Alle ansehen"-Link anzeigen, oder horizontaler Scroll

Schritt 4: Qualitätsprüfung

Vor der Ausgabe der Dateien die Checkliste vor der Auslieferung durchgehen.

Ausgabestruktur

index.html

Vollständiges semantisches HTML5. CDN-Links für Google Fonts und GSAP 3.12.5. Gesamter Inhalt inline. Abschnitte: Nav, Hero, About, Projekte (falls zutreffend), optional Marquee/Skills, Kontakt, Footer. Enthält:

  • <!DOCTYPE html>, <html lang="en">, charset, viewport
  • <title> mit Benutzername + Rolle
  • <meta name="description"> mit Bio
  • OG-Tags: og:title, og:description, og:type (website)
  • Google Fonts <link rel="preconnect"> + Stylesheet
  • GSAP + ScrollTrigger CDN mit defer
  • <link rel="stylesheet" href="css/style.css">
  • <script src="js/main.js" defer> am Ende von body

css/style.css

Alle Styles. CSS-Custom-Properties bei :root (mindestens 20 Variablen, die Farben, Schriftarten, Abstände, Randradius, Easing abdecken). Vollständig responsiv (768px + 480px Breakpoints). Muss enthalten:

  • Reset: *, *::before, *::after { margin:0; padding:0; box-sizing:border-box }
  • html { scroll-behavior: smooth } + benutzerdefinierte Scrollleiste
  • body { overflow-x: hidden; -webkit-font-smoothing: antialiased }
  • ::selection mit Themen-Akzent
  • Rausch-Overlay (Inline-SVG feTurbulence, Deckkraft 0.02–0.04)
  • .reveal-up { opacity: 0; transform: translateY(30px) } Ausgangszustand
  • @media (prefers-reduced-motion: reduce) — alle Animationen deaktivieren, Cursor-Glow ausblenden
  • Jedes dekorative fixed/absolute Element: pointer-events: none

js/main.js

GSAP-Animationen, eingewickelt in DOMContentLoaded. Beginnt mit GSAP-Verfügbarkeitsprüfung:

if (typeof gsap === 'undefined') {
    document.querySelectorAll('.reveal-up').forEach(el => {
        el.style.opacity = '1';
        el.style.transform = 'none';
    });
    return;
}

Registriert ScrollTrigger. Enthält: Hero-Eingangs-Timeline, Scroll-Reveals, Statistikzähler, Kartenkipping, Cursor-Glow, magnetische Schaltflächen, Parallaxe, Nav-Shrink. references/animations/gsap-patterns.md für genaue Implementierungen lesen.

Personalisierungspunkte

PositionDatenquelleFallback
<title>Name + Rolle"Portfolio"
<meta description>Rolle + FähigkeitenAus Rolle generiert
OG-TagsWie Titel/BeschreibungGleich
Nav-LogoHandle in Klammern [MX]Initialen
Hero h1Rolle oder IdentitätsaussageBereich + "Builder"
Hero-UntertitelRollen getrennt durch ·3 Fähigkeitenbereiche
Hero-Badge@handle"@username"
Avatar src + altBenutzerpfadCSS-Verlaufskreis mit Initialen
Social-ButtonsNur tatsächliche URLsButton weglassen, wenn keine URL
About-ÜberschriftPersönliche Aussage"Building at the intersection of X, Y & Z"
About-BioVom Benutzer bereitgestellt oder synthetisiert3-Satz-Bio
TagsFähigkeitenbereicheAus Rolle/Projekten
Statistik-KartenEchte Zahlen + BeschriftungenSchätzungen aus Kontext
ProjektkartenTitel, Beschreibung, Tags, LinksAus Projektinfo
KontaktkartenPlattform, Handle, URLNur bereitgestellte Plattformen
FooterName + new Date().getFullYear()Dynamisches Jahr via JS

Anti-Patterns

#Anti-PatternWarum es scheitertStattdessen tun
1Inter/Roboto als ÜberschriftenschriftSignalisiert sofort "KI-generiert". Das sind Körper-, keine Auszeichnungsschriften.Unverwechselbare Auszeichnungsschriften verwenden: Syne, Outfit, Instrument Serif, Bricolage Grotesque, Unbounded
2Lila Verlauf auf WeißDer #1 "KI-Slop"-visuelle Klischee seit 2023. Jeder erkennt es.Dunkle Hintergründe mit lebendigen Akzenten oder warme Paletten.
3Space Grotesk als StandardWar 2023 unverwechselbar, jetzt die am häufigsten verwendete Schrift in KI-generierten Seiten.Über 12 kuratierte Paarungen rotieren. Nur verwenden, wenn der Benutzer explizit damit brandet.
4opacity:0 ohne GSAP-FallbackWenn GSAP CDN fehlschlägt, ist die gesamte Seite unsichtbar. Leere Seite.Erste JS-Zeile: typeof gsap prüfen, wenn undefiniert alle .reveal-up auf sichtbar setzen.
5Großartiger Hero, generisch unter der Falte"Wow" stirbt beim Scrollen. Standardkarten unter einem filmreifen Hero.Jeder Bereich erhält gleiche Designaufmerksamkeit. Die Scroll-Reise IST das Portfolio.
6href="#" bei Social-LinksMacht die Seite offensichtlich gefälscht. Tötet Glaubwürdigkeit.Tatsächliche URLs verwenden. Wenn keine bereitgestellt, den Button vollständig weglassen.
7Gleiches Animationstiming überallAlles mit gleicher Geschwindigkeit und gleichem Easing wirkt roboterhaft.Dauern variieren (0.4 s–1.2 s). Unterschiedliche Easings pro Element. Mit negativen Offsets staffeln.
8Dekorative Elemente ohne pointer-events: noneKugeln, Rauschen, Cursor-Glow blockieren Mausklicks auf darunterliegendem Inhalt.Jedes dekorative fixed/absolute Element erhält pointer-events: none.
9Verlaufstext auf VerlaufshintergrundNicht lesbar. Zwei konkurrierende Verläufe heben sich gegenseitig auf.Verlaufstext nur auf festen/fast festen dunklen Hintergründen. Ein Verlauf pro visuellem Bereich.
10Fehlendes cursor: pointer auf KartenKarte sieht interaktiv aus, aber Cursor bleibt Standard. Benutzer verwirrt.cursor: pointer auf jedem Element mit Hover-Zustand oder Klick-Handler.
11Emoji-Symbole in der BenutzeroberflächeUniverselles "KI hat das gemacht"-Signal. Kein Designaufwand.Inline-SVG aus assets/social-icons.svg. Keine Emojis in Nav, Buttons, Headern.
12width: 100vwUnter Windows inklusive Scrollleistenbreite → horizontaler Überlauf.width: 100% oder overflow-x: hidden auf body verwenden.
13Symbolbibliothek für 5 Symbole ladenZusätzliche HTTP-Anfrage, FOUC, CDN-Abhängigkeit für ~2 KB SVG-Pfade.Inline-SVG direkt in HTML. 5–8 soziale Symbole = ~2 KB inline.
14Generischer CTA-Text"Let's Connect" / "Get In Touch" – jedes KI-Portfolio verwendet diese.Passend zur Persönlichkeit: "Let's Build Something" (Builder), "Say gm" (Crypto), "Drop a Line" (locker).
15Fehlendes alt auf AvatarScheitert an Barrierefreiheit. Screenreader sagen nichts an.alt="[Benutzername]" – einfach, beschreibend.
164+ Farben Regenbogen-VerlaufstextSieht aus wie ein Spielzeug. Mehrfarbige Verläufe funktionieren selten.Maximal 2–3 Farben aus derselben Familie (pink → lila, nicht pink → grün → blau).

Erforderliche Animationen

references/animations/gsap-patterns.md für Implementierungen lesen. Jede Seite muss enthalten:

  1. Hero-Eingangs-Timeline – gestaffeltes .from(): Avatar (back.out), Badge, Titelzeilen, Untertitel, Socials (back.out gestaffelt), Scroll-Indikator. Überlappend mit negativen Offsets.
  2. Scroll-Reveals – .reveal-up-Elemente animieren von {y:30, opacity:0} bei start: "top 85%". Gestaffelt innerhalb von Ansichtsfenstergruppen.
  3. Statistikzähler – animieren von 0 auf Ziel via onUpdate. Ausgelöst beim Scrollen.
  4. Kartenkippung – mousemove → rotateX/rotateY aus Cursor-Offset. transformPerspective: 1000. Zurücksetzen bei mouseleave.
  5. Cursor-Glow – 600px radialer Verlauf folgt der Maus mit requestAnimationFrame + 0.08 Lerp.
  6. Magnetische Schaltflächen – Social-Buttons bewegen sich zum Cursor (0.3x Faktor), schnappen zurück mit elastic.out(1, 0.5).
  7. Parallax-Hintergrund – dekorative Elemente bewegen sich beim Scrollen mit scrub: 1.
  8. Nav-Shrink – .scrolled-Klasse bei 80px Scrolltiefe umschalten.

Optional (basierend auf Thema/Inhalt hinzufügen):

  • Marquee mit Scroll-Geschwindigkeits-Boost
  • Text-Split-Buchstabe-für-Buchstabe-Reveal (Cyberpunk/dramatisch)
  • Horizontaler Scroll für 5+ Projekte
  • Verlaufstext-Glitzern bei Hover
  • Bereichsbeschriftung von links einschieben

Qualitäts-Checkliste

Strukturell:

  • Alle 3 Dateien generiert (index.html, css/style.css, js/main.js)
  • DOCTYPE, charset, viewport, lang-Attribut vorhanden
  • OG-Meta-Tags mit tatsächlichen Informationen des Benutzers
  • Alle CSS-Custom-Properties in :root
  • GSAP CDN-Links mit defer
  • JS am Ende von body mit defer verlinkt

Inhalt:

  • Alle Benutzerdaten eingefügt (Name, Links, Projekte, Bio)
  • Keine generischen Platzhalter ("Lorem ipsum", "Your Name Here")
  • Social-Links verwenden tatsächliche URLs, kein href="#" für bereitgestellte Links
  • Footer hat korrekten Namen und dynamisches Jahr

Visuell:

  • Schriftpaarung ist NICHT Inter, Roboto, Arial oder Space Grotesk (es sei denn, vom Benutzer angegeben)
  • Kein Lila-auf-Weiß-Farbschema
  • Keine Emoji-Symbole in der Benutzeroberfläche
  • Farbkontrast erfüllt WCAG AA (4.5:1 für Fließtext)
  • Responsive bei 375px, 768px, 1440px – kein horizontaler Scroll
  • prefers-reduced-motion deaktiviert Animationen und blendet Cursor-Glow aus

Technisch:

  • GSAP-Fallback vorhanden (typeof-Prüfung + Opacity-Reset)
  • Alle dekorativen Elemente haben pointer-events: none
  • Kein width: 100vw in CSS
  • Alle interaktiven Elemente haben cursor: pointer
  • Bilder haben alt-Attribute
  • Externe Links haben target="_blank" rel="noopener"

Verwandte Skills