Communitygithub.com

GSAP-Portfolio-Skill

Erstelle künstlerische, GSAP-animierte Portfolio-Websites und -Abschnitte für Softwareentwickler.

Was ist GSAP-Portfolio-Skill?

Dieses Skill befähigt KI-Agenten (wie Claude Code oder Cursor) dazu, außergewöhnliche Portfolio-Websites zu bauen, die sich wie ein kreatives Studio anfühlen, aber die Seele eines Softwareentwicklers bewahren. Es basiert auf der Philosophie 'purposeful drama' – jede Animation soll etwas enthüllen, nicht nur um der Bewegung willen da sein. Der Skill lädt GSAP und ScrollTrigger von CDN oder via npm, stellt sechs leistungsstarke Animationsmuster bereit (gestaffelte Einblendungen, Text-Split-Animationen, scrollgesteuerte Pinning, Parallax-Ebenen, magnetische Cursor-Effekte und horizontale Scroll-Abschnitte) und bietet fünf ästhetische Richtungen: Terminal Noir, Brutalist Code, Soft Engineering, Neon Architect und Analog Digital. Die Sektionen (Hero, About, Skills, Projekte, Kontakt) sind als eigenständige Szenen konzipiert, die zusammen eine narrative Reise ergeben. Zusätzlich enthält der Skill Regeln für Typografie-Paarungen, Farbschemata, Performance (will-change, transform/opacity, matchMedia für Mobile), Responsivität (clamp(), horizontale Scrollen wird auf Mobile vertikal) und Barrierefreiheit (prefers-reduced-motion, semantisches HTML, Tastaturnavigation). Das Ergebnis ist eine einzelne HTML-Datei mit eingebettetem CSS und JS, die den Nutzer beim Scrollen fesselt.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/TasmiaZerin1128/TasmiaZerin1128.github.io/tree/HEAD/.claude/skills

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht GSAP-Portfolio-Skill?

Baue Portfolio-Websites, die sich anfühlen, als kämen sie von einem kreativen Studio – aber mit der Seele eines Softwareentwicklers. Das Ziel ist niemals ein langweiliges 'Corporate-Dev-Portfolio mit Held und Karten'. Das Ziel ist ein Erlebnis, das jemanden zum Stoppen des Scrollens bringt.

Philosophie

Entwickler-Portfolios scheitern auf zwei Arten: Sie sind entweder langweilig (weiße Seite, Kartenraster, 'Hi, ich bin ein Entwickler') oder sie bemühen sich zu sehr mit Effekten, die sich vom Inhalt losgelöst anfühlen. Der Sweet Spot ist zielgerichtetes Drama – jede Animation sollte sich anfühlen, als würde sie etwas enthüllen, nicht nur um der Bewegung willen da sein.

Betrachte das Portfolio als eine Erzählung, nicht als eine Seite. Der Besucher wird durch eine Geschichte geführt: Wer du bist → Was du gebaut hast → Wie du denkst → Wie man dich erreicht.

GSAP-Integration

Lade GSAP immer vom CDN. Verwende die neueste Version vom GSAP-CDN (nicht cdnjs):

<script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/ScrollTrigger.min.js"></script>

Für React-Projekte per npm installieren:

npm install gsap
import gsap from 'gsap';
import { ScrollTrigger } from 'gsap/ScrollTrigger';
gsap.registerPlugin(ScrollTrigger);

Wichtige GSAP-Muster

1. Gestaffelte Einblendungen – Die Grundlage. Zeige eine Gruppe von Elementen niemals alle auf einmal an.

gsap.from('.skill-item', {
  y: 60,
  opacity: 0,
  duration: 0.8,
  stagger: 0.12,
  ease: 'power3.out',
  scrollTrigger: {
    trigger: '.skills-section',
    start: 'top 80%',
  }
});

2. Text-Split-Animationen – Teile Überschriften in Zeichen/Wörter auf und animiere sie ein. Dies ist die wichtigste Animation. Verwende das SplitText-Plugin, falls verfügbar, oder teile manuell mit Spans:

// Manuelle Zeichenaufteilung
const heading = document.querySelector('.hero-title');
heading.innerHTML = heading.textContent.split('').map(
  (char, i) => `<span class="char" style="display:inline-block">${char === ' ' ? '&nbsp;' : char}</span>`
).join('');

gsap.from('.char', {
  y: 120,
  opacity: 0,
  rotateX: -80,
  stagger: 0.03,
  duration: 1,
  ease: 'power4.out',
});

3. Scrollgesteuertes Pinning – Fixiere Abschnitte und animiere den Inhalt darin, während der Benutzer scrollt. Erzeugt dieses 'filmische' Gefühl.

gsap.timeline({
  scrollTrigger: {
    trigger: '.pinned-section',
    start: 'top top',
    end: '+=200%',
    pin: true,
    scrub: 1,
  }
})
.from('.reveal-1', { xPercent: -100, opacity: 0 })
.from('.reveal-2', { yPercent: 50, opacity: 0 }, '-=0.3')
.from('.reveal-3', { scale: 0.8, opacity: 0 }, '-=0.3');

4. Parallax-Ebenen – Gib Tiefe mit unterschiedlichen Scrollgeschwindigkeiten.

gsap.to('.bg-layer', {
  yPercent: -30,
  ease: 'none',
  scrollTrigger: {
    trigger: '.parallax-section',
    start: 'top bottom',
    end: 'bottom top',
    scrub: true,
  }
});

5. Magnetische / Cursor-Follow-Effekte – Für interaktive Elemente wie CTAs oder vorgestellte Projekte.

const btn = document.querySelector('.magnetic-btn');
btn.addEventListener('mousemove', (e) => {
  const rect = btn.getBoundingClientRect();
  const x = e.clientX - rect.left - rect.width / 2;
  const y = e.clientY - rect.top - rect.height / 2;
  gsap.to(btn, { x: x * 0.3, y: y * 0.3, duration: 0.4, ease: 'power2.out' });
});
btn.addEventListener('mouseleave', () => {
  gsap.to(btn, { x: 0, y: 0, duration: 0.6, ease: 'elastic.out(1, 0.4)' });
});

6. Horizontale Scroll-Abschnitte – Perfekt für Projektpräsentationen. Vertikal scrollen, aber der Inhalt bewegt sich horizontal.

const track = document.querySelector('.horizontal-track');
const items = gsap.utils.toArray('.project-card');

gsap.to(items, {
  xPercent: -100 * (items.length - 1),
  ease: 'none',
  scrollTrigger: {
    trigger: track,
    pin: true,
    scrub: 1,
    end: () => '+=' + track.scrollWidth,
  }
});

Lies references/gsap-patterns.md für fortgeschrittenere Muster, darunter morphing shapes, custom cursor trails, Noise-basierte Bewegungen und WebGL-Integrationshinweise.

Ästhetische Richtung

Für das Portfolio eines Softwareentwicklers funktionieren diese ästhetischen Richtungen am besten. Wähle eine pro Projekt – vermische sie niemals:

1. Terminal Noir

Dunkler Hintergrund, monospaced Schrift gemischt mit einer scharfen serifenlosen Schrift, grüne/gelbe/cyanfarbene Akzente auf Schwarz. Fühlt sich an, als wäre man in einem Terminal – aber einem schönen. Verwende Scanline-Overlays, blinkende Cursor, Tipp-Animationen. Denk an: Hacker-Ästhetik trifft Editorial Design.

2. Brutalist Code

Rohe, offene Struktur. Sichtbare Gitterlinien, große monospaced Schrift, harter Kontrast. Elemente wirken, als wären sie absichtlich mit position: absolute platziert worden. Animationen sind kurz und mechanisch – kein ease-out, verwende steps() oder power4.inOut. Denk an: als hätte ein Compiler Geschmack.

3. Soft Engineering

Helle Hintergründe mit warmen Neutraltönen, großzügiger Weißraum, elegante Serifenschrift für Überschriften kombiniert mit einer sauberen serifenlosen Schrift. Sanfte, fließende Animationen. Wirkt erstklassig und ruhig. Denk an: als hätte Dieter Rams ein Portfolio entworfen.

4. Neon Architect

Dunkle Basis, leuchtende Neon-Akzente (Magenta, Elektroblau, Limette), Glas-Morphismus, Glow-Effekte. Animationen sind flüssig und wirken fast flüssig. Gitternetzbasiertes Layout mit überlappenden Elementen. Denk an: Blade Runner trifft Schweizer Design.

5. Analog Digital

Papierstrukturen, handgezeichnete Elemente gemischt mit scharfer digitaler Schrift, subtile Kornüberlagerungen. Warme Farbpalette. Animationen ahmen physische Bewegungen nach – Dinge gleiten wie Papier, stapeln sich wie Karten. Denk an: ein Entwickler, der auch skizziert.

Abschnittsarchitektur

Ein starkes Portfolio folgt dieser Struktur. Jeder Abschnitt sollte sich wie eine eigene 'Szene' anfühlen:

Hero

Die ersten 3 Sekunden sind am wichtigsten. Beginne mit einer Textanimation – der Besucher sollte deinen Namen zum Leben erwachen sehen. Füge eine subtile Hintergrundanimation hinzu (schwebende Partikel, sich verwandelnde Formen, Farbverlaufsanimation). Halte die Botschaft toteneinfach: Name + Identität in einem Satz.

Über mich / Philosophie

Zähle nicht nur Fakten auf. Drücke eine Weltanschauung aus. Verwende eine scrollgesteuerte Einblendung, um Text Zeile für Zeile zu enthüllen. Ein Foto ist optional, aber falls vorhanden, verwende eine kreative Behandlung (Duoton, Clip-Path-Reveal, Parallax-Versatz).

Fähigkeiten / Tech-Stack

Verwende NIEMALS ein langweiliges Raster von Logos. Versuche stattdessen: eine orbitale Visualisierung, einen laufenden Ticker/Marquee, interaktive Tags, die auf Hover reagieren, eine Konstellationskarte oder eine Terminal-ähnliche Liste, die sich selbst 'schreibt'.

Projekte

Das Herzstück. Jedes Projekt braucht Atemraum. Verwende entweder: horizontale Scroll-Galerie, vollbildgestapelte Karten, die pinnen und übergehen, oder erweiterbare Karten mit scrollgesteuerten Einblendungen. Jedes Projekt sollte zeigen: Titel, kurze Beschreibung, verwendete Technologien und ein visuelles Element (Screenshot, Video oder kreative Illustration).

Kontakt / Footer

Beende mit Absicht. Ein großer typografischer CTA, vielleicht eine zeitbasierte Begrüßung ('Guten Abend – lass uns reden'), und saubere Kontaktlinks. Halte es prägnant.

Lies references/portfolio-sections.md für detaillierte HTML/CSS/JS-Vorlagen für jeden Abschnittstyp.

Typografie-Regeln

Importiere Schriftarten von Google Fonts. Verwende niemals Systemschriften oder Inter/Roboto.

Gute Paarungen für Entwickler-Portfolios:

  • Anzeige + Text: 'Clash Display' + 'Satoshi' (über fontshare.com CDN)
  • Anzeige + Text: 'Syne' + 'Work Sans' (Google Fonts)
  • Anzeige + Text: 'Space Grotesk' + 'DM Sans' (Google Fonts) – nur für einen technischen Vibe
  • Monospaced + Serifenlos: 'JetBrains Mono' + 'General Sans' (fontshare) – für die Terminal-Ästhetik
  • Serifen + Serifenlos: 'Playfair Display' + 'Source Sans 3' – für die weiche/hochwertige Richtung
  • Anzeige + Text: 'Anybody' + 'Instrument Sans' (Google Fonts)
  • Anzeige + Text: 'Bricolage Grotesque' + 'Geist' (via CDN)

Lade via:

<link href="https://api.fontshare.com/v2/css?f[]=clash-display@400,500,600,700&f[]=satoshi@400,500,700&display=swap" rel="stylesheet">

oder

<link href="https://fonts.googleapis.com/css2?family=Syne:wght@400;500;600;700;800&family=Work+Sans:wght@300;400;500;600&display=swap" rel="stylesheet">

Farbregeln

Definiere eine Palette mit CSS-Custom-Properties. Jede Palette benötigt:

  • --bg: Haupthintergrund
  • --fg: Haupttext
  • --accent: Primäre Akzentfarbe
  • --accent-2: Sekundäre Akzentfarbe (optional)
  • --muted: Gedämpfter Text/Rahmen
  • --surface: Karten-/Abschnittshintergrund

Beispiel (Terminal Noir):

:root {
  --bg: #0a0a0a;
  --fg: #e8e8e8;
  --accent: #00ff88;
  --accent-2: #0088ff;
  --muted: #333;
  --surface: #111;
}

Beispiel (Soft Engineering):

:root {
  --bg: #f8f5f0;
  --fg: #1a1a1a;
  --accent: #c45d3e;
  --accent-2: #2d5a7b;
  --muted: #b8b0a4;
  --surface: #ffffff;
}

Performance-Regeln

GSAP ist standardmäßig performant, aber befolge diese Regeln:

  • Verwende will-change: transform auf animierten Elementen
  • Bevorzuge transform und opacity vor Layout-Eigenschaften (width, height, top, left)
  • Verwende ScrollTrigger.batch() für viele ähnliche Elemente anstelle einzelner Trigger
  • Füge loading="lazy" zu Bildern unter dem Falz hinzu
  • Halte das Gesamtgewicht der Seite unter 2 MB (ohne Videos)
  • Verwende gsap.matchMedia(), um schwere Animationen auf Mobilgeräten zu deaktivieren:
gsap.matchMedia().add('(max-width: 768px)', () => {
  // Einfachere mobile Animationen hier
});

Reaktionsfähigkeit

Jeder Abschnitt muss auf Mobilgeräten funktionieren. Wichtige Regeln:

  • Schriftgrößen: Verwende clamp() für fließende Skalierung – z. B. clamp(2rem, 5vw, 5rem)
  • Horizontale Scroll-Abschnitte sollten auf Mobilgeräten zur vertikalen Stapelung übergehen
  • Fixierte Abschnitte: Reduziere die Pin-Dauer oder entferne das Pin auf Mobilgeräten via gsap.matchMedia()
  • Touch-Ziele: Schaltflächen/Links mindestens 44px
  • Teste bei den Breakpoints 375px, 768px, 1440px

Barrierefreiheit

Animierte Portfolios müssen trotzdem barrierefrei sein:

  • Respektiere prefers-reduced-motion:
const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
if (prefersReduced) {
  gsap.globalTimeline.timeScale(0); // oder Animationen ganz überspringen
}
  • Semantisches HTML: Verwende <main>, <section>, <nav>, <header>, <footer>
  • Alt-Texte auf allen Bildern
  • Mit Tastatur navigierbare interaktive Elemente
  • Ausreichender Farbkontrast (mindestens 4.5:1 für Fließtext)

Beim Erstellen

  1. Beginne mit der ästhetischen Richtung – bestätige mit dem Benutzer oder wähle basierend auf seinem Vibe
  2. Baue die HTML-Struktur mit semantischen Abschnitten
  3. Style mit CSS (Custom Properties, fließende Schrift, Grid/Flexbox)
  4. Füge GSAP-Animationen Abschnitt für Abschnitt hinzu
  5. Füge ScrollTrigger für scrollgesteuerte Einblendungen hinzu
  6. Füge Interaktivität hinzu (Hover-Zustände, Cursor-Effekte, Mikrointeraktionen)
  7. Mache es reaktionsfähig
  8. Füge prefers-reduced-motion-Handling hinzu
  9. Optimiere (Lazy Loading, will-change, matchMedia für Mobilgeräte)

Gebe immer eine einzelne HTML-Datei mit eingebettetem CSS und JS aus, es sei denn, der Benutzer gibt ein Framework an.

Verwandte Skills