Communitygithub.com

TasmiaZerin1128/TasmiaZerin1128.github.io

소프트웨어 엔지니어를 위한 예술적인 GSAP 애니메이션 포트폴리오 웹사이트 및 섹션을 구축합니다. 사용자가 포트폴리오, 개인 웹사이트, 개발자 랜딩 페이지, 자기소개 섹션, 스킬 섹션, 프로젝트 쇼케이스, 히어로 섹션 또는 창의적이고 애니메이션이 강조된 웹 구성 요소를 요청할 때 이 스킬을 사용하세요.

TasmiaZerin1128.github.io란 무엇인가요?

이 스킬은 소프트웨어 엔지니어를 위한 고품질의 애니메이션 포트폴리오 웹사이트를 구축하는 데 특화되어 있습니다. GSAP(GreenSock Animation Platform) 라이브러리와 ScrollTrigger 플러그인을 활용하여 단순한 카드 그리드가 아닌, 방문자가 스크롤을 멈추게 만드는 '경험'을 창출하는 데 중점을 둡니다. 텍스트 분할 애니메이션, 지연된 등장 효과, 패럴랙스 스크롤, 마그네틱 커서 효과, 가로 스크롤 섹션 등 6가지 핵심 GSAP 패턴을 제공하며, '터미널 느와르', '브루탈리스트 코드' 등 5가지 미학적 방향 중 선택하여 일관된 디자인을 구현합니다. 또한 성능, 반응형, 접근성( prefers-reduced-motion 대응)에 대한 엄격한 규칙을 따르며, 최종 결과물은 단일 HTML 파일에 CSS와 JS가 내장된 형태로 제공됩니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/TasmiaZerin1128/TasmiaZerin1128.github.io/tree/HEAD/.claude/skills

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

GSAP 포트폴리오 스킬

소프트웨어 엔지니어의 영혼을 담되, 마치 크리에이티브 스튜디오가 제작한 듯한 느낌의 포트폴리오 웹사이트를 구축하세요. 목표는 결코 "히어로와 카드가 있는 평범한 개발자 포트폴리오"가 아닙니다. 목표는 누군가가 스크롤을 멈추게 만드는 경험입니다.

철학

개발자 포트폴리오는 두 가지 방식으로 실패합니다. 지루하거나(흰 페이지, 카드 그리드, "안녕하세요 저는 개발자입니다") 아니면 내용과 동떨어진 효과로 너무 과하게 꾸미는 것입니다. 적절한 지점은 의미 있는 드라마입니다. 모든 애니메이션은 단순히 움직이기 위한 것이 아니라 무언가를 드러내는 듯한 느낌을 주어야 합니다.

포트폴리오를 페이지가 아닌 이야기로 생각하세요. 방문자는 이야기를 따라 안내됩니다: 당신은 누구인가 → 무엇을 구축했는가 → 어떻게 생각하는가 → 어떻게 연락할 수 있는가.

GSAP 통합

항상 CDN에서 GSAP를 불러오세요. 최신 버전은 cdnjs가 아닌 GSAP CDN을 사용하세요:

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

React 프로젝트의 경우 npm을 통해 설치하세요:

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

핵심 GSAP 패턴

1. 지연된 등장(Staggered Reveals) — 가장 기본적이면서도 중요한 패턴입니다. 요소 그룹을 한 번에 모두 드러내지 마세요.

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. 텍스트 분할 애니메이션 — 제목을 문자/단어로 분할하여 애니메이션을 적용합니다. 추가할 수 있는 단일 애니메이션 중 가장 영향력이 큽니다. SplitText 플러그인을 사용할 수 있으면 사용하고, 그렇지 않으면 span을 사용하여 수동으로 분할하세요:

// 수동 문자 분할
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. 스크롤 기반 고정(Pinning) — 섹션을 고정하고 사용자가 스크롤할 때 내부 콘텐츠에 애니메이션을 적용합니다. "영화 같은" 느낌을 만듭니다.

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. 패럴랙스 레이어 — 서로 다른 스크롤 속도로 깊이감을 줍니다.

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

5. 마그네틱 / 커서 추적 효과 — CTA나 주요 프로젝트 같은 인터랙티브 요소에 사용합니다.

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. 가로 스크롤 섹션 — 프로젝트 쇼케이스에 완벽합니다. 세로로 스크롤하지만 콘텐츠는 가로로 움직입니다.

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,
  }
});

고급 패턴(모핑 셰이프, 사용자 지정 커서 트레일, 노이즈 기반 움직임, WebGL 통합 힌트)은 references/gsap-patterns.md 파일을 참조하세요.

미학적 방향(Aesthetic Direction)

소프트웨어 엔지니어의 포트폴리오에는 다음 미학적 방향이 가장 잘 맞습니다. 프로젝트당 하나를 선택하고 절대 혼합하지 마세요:

1. 터미널 느와르(Terminal Noir)

어두운 배경, 고정폭 글꼴과 날카로운 산세리프체의 조합, 검정 바탕의 녹색/호박색/청록색 액센트. 아름다운 터미널 내부에 있는 듯한 느낌을 줍니다. 스캔라인 오버레이, 깜빡이는 커서, 타이핑 애니메이션을 사용하세요. 해커 미학과 편집 디자인의 만남을 생각해보세요.

2. 브루탈리스트 코드(Brutalist Code)

생생하고 노출된 구조. 눈에 띄는 그리드 라인, 큰 고정폭 글꼴, 강한 대비. 요소들이 의도적으로 position: absolute로 배치된 듯한 느낌을 줍니다. 애니메이션은 경쾌하고 기계적입니다. ease-out 대신 steps()나 power4.inOut을 사용하세요. 컴파일러가 취향을 가졌다면 이렇겠죠.

3. 소프트 엔지니어링(Soft Engineering)

밝은 배경과 따뜻한 중성색, 넉넉한 여백, 제목에는 우아한 세리프체, 본문에는 깔끔한 산세리프체를 사용합니다. 부드럽고 흐르는 듯한 애니메이션. 프리미엄하고 차분한 느낌을 줍니다. 디터 람스가 포트폴리오를 디자인한다면 이렇겠죠.

4. 네온 아키텍트(Neon Architect)

어두운 베이스, 선명한 네온 액센트(마젠타, 전기 파랑, 라임), 유리모피즘(glassmorphism), 글로우 효과. 애니메이션은 유동적이고 거의 액체처럼 느껴집니다. 겹치는 요소가 있는 그리드 기반 레이아웃. 블레이드 러너와 스위스 디자인의 만남을 생각해보세요.

5. 아날로그 디지털(Analog Digital)

종이 질감, 손으로 그린 요소와 날카로운 디지털 글꼴의 혼합, 미세한 그레인 오버레이. 따뜻한 색상 팔레트. 애니메이션은 물리적 움직임을 모방합니다. 종이처럼 미끄러지고 카드처럼 쌓입니다. 스케치도 하는 개발자를 생각해보세요.

섹션 아키텍처

강력한 포트폴리오는 다음 구조를 따릅니다. 각 섹션은 고유한 "장면"처럼 느껴져야 합니다:

히어로

처음 3초가 가장 중요합니다. 텍스트 애니메이션으로 시작하세요. 방문자가 당신의 이름이 살아 움직이는 것을 볼 수 있어야 합니다. 배경에는 미묘한 앰비언트 애니메이션(떠다니는 입자, 모핑 셰이프, 그라데이션 애니메이션)을 포함하세요. 메시지는 매우 간단하게 유지하세요: 이름 + 한 줄 정체성.

소개 / 철학

단순히 사실을 나열하지 마세요. 세계관을 표현하세요. 스크롤 트리거 등장 효과를 사용하여 텍스트를 한 줄씩 드러내세요. 사진은 선택 사항이지만 포함하는 경우 창의적인 처리(듀오톤, 클립 패스 등장, 패럴랙스 오프셋)를 사용하세요.

스킬 / 기술 스택

절대 지루한 로고 그리드를 사용하지 마세요. 대신 다음을 시도해보세요: 궤도 시각화, 스크롤링 티커/마키, 호버에 반응하는 인터랙티브 태그, 별자리 지도, 또는 스스로 "타이핑"되는 터미널 스타일 목록.

프로젝트

가장 중요한 부분입니다. 각 프로젝트에는 숨 쉴 공간이 필요합니다. 다음 중 하나를 사용하세요: 가로 스크롤 갤러리, 고정 및 전환되는 전체 화면 누적 카드, 또는 스크롤 트리거 등장 효과를 가진 확장형 카드. 각 프로젝트에는 제목, 간단한 설명, 사용된 기술, 시각 자료(스크린샷, 비디오 또는 창의적인 일러스트레이션)가 표시되어야 합니다.

연락처 / 푸터

의도를 가지고 마무리하세요. 큰 활자체의 CTA, 시간 기반 인사말("좋은 저녁입니다 — 이야기 나눠요"), 깔끔한 연락처 링크. 간결하게 유지하세요.

각 섹션 유형에 대한 자세한 HTML/CSS/JS 템플릿은 references/portfolio-sections.md 파일을 참조하세요.

타이포그래피 규칙

Google Fonts에서 폰트를 가져오세요. 시스템 폰트나 Inter/Roboto는 절대 사용하지 마세요.

개발자 포트폴리오를 위한 좋은 조합:

  • 디스플레이 + 본문: "Clash Display" + "Satoshi" (fontshare.com CDN 사용)
  • 디스플레이 + 본문: "Syne" + "Work Sans" (Google Fonts)
  • 디스플레이 + 본문: "Space Grotesk" + "DM Sans" (Google Fonts) — 기술적인 분위기에만 사용
  • 고정폭 + 산세리프: "JetBrains Mono" + "General Sans" (fontshare) — 터미널 미학용
  • 세리프 + 산세리프: "Playfair Display" + "Source Sans 3" — 부드럽고 프리미엄한 방향
  • 디스플레이 + 본문: "Anybody" + "Instrument Sans" (Google Fonts)
  • 디스플레이 + 본문: "Bricolage Grotesque" + "Geist" (CDN 사용)

다음과 같이 불러오세요:

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

또는

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

색상 규칙

CSS 커스텀 속성을 사용하여 팔레트를 정의하세요. 모든 팔레트에는 다음이 필요합니다:

  • --bg: 메인 배경
  • --fg: 메인 텍스트
  • --accent: 주요 강조 색상
  • --accent-2: 보조 강조 색상 (선택 사항)
  • --muted: 희미한 텍스트 / 테두리
  • --surface: 카드/섹션 배경

예시 (터미널 느와르):

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

예시 (소프트 엔지니어링):

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

성능 규칙

GSAP는 기본적으로 성능이 좋지만, 다음을 따르세요:

  • 애니메이션 요소에 will-change: transform 사용
  • 레이아웃 속성(width, height, top, left)보다 transform과 opacity를 선호
  • 유사한 요소가 많으면 개별 트리거 대신 ScrollTrigger.batch() 사용
  • 아래쪽 이미지에는 loading="lazy" 추가
  • 총 페이지 무게를 2MB 미만으로 유지 (비디오 제외)
  • gsap.matchMedia()를 사용하여 모바일에서 무거운 애니메이션 비활성화:
gsap.matchMedia().add('(max-width: 768px)', () => {
  // 여기에 더 간단한 모바일 애니메이션 작성
});

반응형

모든 섹션은 모바일에서 작동해야 합니다. 주요 규칙:

  • 글꼴 크기: 유동적인 크기 조정을 위해 clamp() 사용 — 예: clamp(2rem, 5vw, 5rem)
  • 가로 스크롤 섹션은 모바일에서 세로 쌓기로 변환
  • 고정된 섹션: gsap.matchMedia()를 통해 모바일에서 고정 지속 시간을 줄이거나 고정 제거
  • 터치 대상: 버튼/링크는 최소 44px
  • 375px, 768px, 1440px 중단점에서 테스트

접근성

애니메이션 포트폴리오도 접근 가능해야 합니다:

  • prefers-reduced-motion을 존중:
const prefersReduced = window.matchMedia('(prefers-reduced-motion: reduce)').matches;
if (prefersReduced) {
  gsap.globalTimeline.timeScale(0); // 또는 애니메이션을 완전히 건너뜀
}
  • 의미론적 HTML: <main>, <section>, <nav>, <header>, <footer> 사용
  • 모든 이미지에 대체 텍스트
  • 키보드로 탐색 가능한 인터랙티브 요소
  • 충분한 색상 대비 (본문 텍스트의 경우 최소 4.5:1)

빌드 순서

  1. 미학적 방향을 결정하세요 — 사용자와 확인하거나 사용자의 분위기에 따라 선택
  2. 의미론적 섹션으로 HTML 구조를 구축
  3. CSS로 스타일링 (커스텀 속성, 유동적 타이포그래피, 그리드/플렉스박스)
  4. 섹션별로 GSAP 애니메이션을 레이어링
  5. 스크롤 기반 등장 효과를 위해 ScrollTrigger 추가
  6. 인터랙티브 요소 추가 (호버 상태, 커서 효과, 마이크로 인터랙션)
  7. 반응형으로 만들기
  8. prefers-reduced-motion 처리 추가
  9. 최적화 (지연 로딩, will-change, 모바일용 matchMedia)

사용자가 프레임워크를 지정하지 않는 한 항상 CSS와 JS가 내장된 단일 HTML 파일을 출력하세요.

관련 스킬