Communitygithub.com

개인 사이트 greenfield — 한 줄 GSAP 포트폴리오

한 줄 프롬프트로 배포 가능한 개인 포트폴리오: 바닐라 HTML/CSS/JS + GSAP, 빌드 제로, 5테마, 12폰트, 16 반AI슬롭 규칙, 8+ 모션. index.html만 열면 실행.

개인 사이트 greenfield — 한 줄 GSAP 포트폴리오란 무엇인가요?

Personal websites 1단계(scaffold): Mort1d portfolio-genesis. 한 줄 → 완성 바닐라 개인 사이트.

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

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

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

문서

Portfolio Genesis

원프롬프트 포트폴리오 생성기. 전문적인 GSAP 애니메이션, 반응형 디자인, AI가 만든 것처럼 보이지 않는 독특한 미적 감각을 갖춘 완전하고 배포 가능한 사이트를 생성합니다. 사용자가 브라우저에서 index.html을 열면 프로덕션 품질의 포트폴리오를 볼 수 있습니다.

철학

  • 모든 포트폴리오는 이야기를 전합니다. 디자인 자체가 포트폴리오의 첫 번째 프로젝트입니다.
  • 안티-템플릿: 생성된 두 사이트가 동일해 보이지 않아야 합니다. 테마는 사용자의 분야, 성격, 어조에 따라 결정됩니다.
  • "index.html을 열고 WOW를 외쳐라" — npm 제로, 빌드 단계 제로, 즉각적인 만족감.
  • 제약 = 자유: 바닐라 HTML/CSS/JS + GSAP는 수제 느낌이 나는 창의적인 CSS를 강제합니다.
  • 잘 제시된 3개의 프로젝트가 있는 포트폴리오가 20개의 일반적인 카드보다 낫습니다. 양보다 질.
  • 스크롤 경험 자체가 포트폴리오입니다. 스크롤되는 모든 픽셀은 의도적으로 느껴져야 합니다.

프로세스

1단계: 정보 수집

사용자 프롬프트에서 추출:

  • 아이덴티티: 이름, 핸들/별칭, 역할/직함
  • 약력: 1-3문장 (제공되지 않은 경우 컨텍스트에서 종합)
  • 프로젝트: 제목, 설명, 태그, 링크, 거래 금액, 역할
  • 소셜: X, Discord, Telegram, GitHub, LinkedIn, 이메일, YouTube (제공된 것만 포함)
  • 아바타: 파일 경로 또는 이니셜로 CSS 그래디언트 원 생성
  • 통계: 경력 연수, 프로젝트 수, 커뮤니티 도달 범위, 탐구한 도구
  • 어조: 전문적 | 해커 | 창의적 | 우아함 | 장난기 | 미니멀 | 사이버

사용자가 최소한의 입력만 제공하는 경우, 컨텍스트에 맞는 플레이스홀더 데이터를 생성하고 삽입 지점을 표시합니다: <!-- CUSTOMIZE: Replace with your Twitter handle -->. URL이 제공되지 않은 경우 소셜 버튼을 완전히 생략합니다 — href="#"를 절대 렌더링하지 마십시오.

2단계: 테마 선택

아래 결정 트리를 사용하여 5가지 테마 중에서 선택합니다. 그런 다음 references/themes/{theme-name}.md에서 테마 파일을 읽습니다.

사용자가 암호화폐/웹3/블록체인 분야인가요?
  예 → "깔끔한"/"미니멀"이 언급되었나요? → 모노-미니멀
        그 외 → 미드나이트-글라스 (기본값) 또는 네온-사이버펑크 ("네온"/"사이버" 언급 시)

사용자가 디자이너/예술가/창작자인가요?
  예 → 어두운 선호? → 미드나이트-글라스
        그 외 → 웜-오가닉 (기본값) 또는 페이퍼-브루탈리스트 ("에디토리얼"/"프린트" 언급 시)

사용자가 개발자/엔지니어인가요?
  예 → 미드나이트-글라스 (기본값) 또는 모노-미니멀 ("깔끔한"/"미니멀" 언급 시)

사용자가 학생/초보자인가요?
  예 → 웜-오가닉 (친근함) 또는 네온-사이버펑크 (젊고 활기찬 경우)

사용자가 비즈니스/전문가인가요?
  예 → 모노-미니멀 (기본값) 또는 웜-오가닉 ("접근하기 쉬운" 경우)

명시적 재정의 (최우선 순위):
  "어두운" / "글라스" → 미드나이트-글라스
  "밝은" / "깔끔한" / "페이퍼" → 페이퍼-브루탈리스트
  "네온" / "사이버" / "미래지향적" → 네온-사이버펑크
  "웜" / "어스틀리" / "오가닉" → 웜-오가닉
  "미니멀" / "모노" / "타이포그래피" → 모노-미니멀

3단계: 파일 생성

다음 순서로 참조 파일을 읽습니다:

  1. references/themes/{선택된-테마}.md — 색상, 글꼴, 카드 스타일
  2. references/animations/gsap-patterns.md — 애니메이션 레시피
  3. references/sections/hero-variants.md — 히어로 레이아웃 선택
  4. references/typography/font-pairings.md — 글꼴 선택 확인

정확히 3개의 파일 생성: index.html, css/style.css, js/main.js

히어로 레이아웃 결정

아바타 이미지가 제공되었나요?
  예 → 가운데 정렬 아바타 (기본값)
        예외: 강력한 프로젝트 쇼케이스를 가진 디자이너 → 분할 히어로
  아니요 → 강력한 제목/태그라인? → 전체 화면 타이포그래피
        그 외 → 미니멀 (이름 + 역할 + 스크롤 표시기)

역할 설명어 수:
  1   → 단일 큰 부제목
  2-3 → 점으로 구분된 부제목 줄
  4+  → GSAP 텍스트 교체를 통한 애니메이션 역할 회전

프로젝트 섹션 결정

프로젝트 수:
  0   → 프로젝트 건너뛰기. 대신 스킬/기술 태그 클라우드 섹션 추가
  1-2 → 큰 주요 카드 (전체 너비 또는 추가 패딩이 있는 2열)
  3-4 → 균일한 크기의 2열 그리드
  5-8 → 벤토 그리드 (1개의 큰 카드 + 작은 카드들)
  9+  → "모두 보기" 링크와 함께 상위 6개 표시 또는 가로 스크롤

4단계: 품질 검사

파일을 출력하기 전에 전달 전 체크리스트를 실행합니다.

출력 구조

index.html

완전한 시맨틱 HTML5. Google Fonts 및 GSAP 3.12.5용 CDN 링크. 모든 콘텐츠 인라인. 섹션: 내비게이션, 히어로, 소개, 프로젝트(해당하는 경우), 선택적 마키/스킬, 연락처, 푸터. 포함:

  • <!DOCTYPE html>, <html lang="en">, charset, viewport
  • 사용자 이름 + 역할이 포함된 <title>
  • 약력이 포함된 <meta name="description">
  • OG 태그: og:title, og:description, og:type (website)
  • Google Fonts <link rel="preconnect"> + 스타일시트
  • GSAP + ScrollTrigger CDN (defer 포함)
  • <link rel="stylesheet" href="css/style.css">
  • <script src="js/main.js" defer> (본문 끝)

css/style.css

모든 스타일. :root의 CSS 사용자 정의 속성 (최소 20개 변수: 색상, 글꼴, 간격, 반경, 이징 포함). 완전한 반응형 (768px + 480px 중단점). 포함:

  • 리셋: *, *::before, *::after { margin:0; padding:0; box-sizing:border-box }
  • html { scroll-behavior: smooth } + 사용자 정의 스크롤바
  • body { overflow-x: hidden; -webkit-font-smoothing: antialiased }
  • 테마 악센트가 있는 ::selection
  • 노이즈 오버레이 (인라인 SVG feTurbulence, 불투명도 0.02-0.04)
  • .reveal-up { opacity: 0; transform: translateY(30px) } 초기 상태
  • @media (prefers-reduced-motion: reduce) — 모든 애니메이션 비활성화, 커서 광택 숨김
  • 모든 장식용 고정/절대 요소: pointer-events: none

js/main.js

DOMContentLoaded로 감싸진 GSAP 애니메이션. GSAP 가용성 확인으로 시작:

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

ScrollTrigger 등록. 포함: 히어로 진입 타임라인, 스크롤 리빌, 통계 카운터, 카드 기울기, 커서 광택, 자기 버튼, 시차 효과, 내비게이션 축소. 정확한 구현은 references/animations/gsap-patterns.md 참조.

개인화 포인트

위치데이터 소스대체값
<title>이름 + 역할"포트폴리오"
<meta description>역할 + 기술역할에서 생성
OG 태그제목/설명과 동일동일
내비게이션 로고대괄호 안의 핸들 [MX]이니셜
히어로 h1역할 또는 정체성 진술분야 + "빌더"
히어로 부제목·로 구분된 역할3가지 기술 영역
히어로 배지@핸들"@username"
아바타 src + alt사용자 경로이니셜이 있는 CSS 그래디언트 원
소셜 버튼실제 URL만URL이 없으면 버튼 생략
소개 제목개인 진술"X, Y & Z의 교차점에서 구축"
소개 약력사용자 제공 또는 종합3문장 약력
태그기술 영역역할/프로젝트에서
통계 카드실제 숫자 + 레이블컨텍스트에서 추정
프로젝트 카드제목, 설명, 태그, 링크프로젝트 정보에서
연락처 카드플랫폼, 핸들, URL제공된 플랫폼만
푸터이름 + new Date().getFullYear()JS를 통한 동적 연도

안티 패턴

#안티 패턴실패 이유대신 이렇게
1제목 글꼴로 Inter/Roboto즉시 "AI 생성" 신호. 이들은 본문 글꼴이지 디스플레이 글꼴이 아닙니다.독특한 디스플레이 글꼴 사용: Syne, Outfit, Instrument Serif, Bricolage Grotesque, Unbounded
2흰색 위에 보라색 그라데이션2023년 이후 최고의 "AI 슬롭" 시각적 클리셰. 모두가 알아봅니다.어두운 배경에 생생한 악센트, 또는 따뜻한 팔레트.
3기본값으로 Space Grotesk2023년에는 독특했지만, 이제 AI 생성 사이트에서 가장 과도하게 사용된 글꼴입니다.12가지 큐레이팅된 페어링을 순환합니다. 사용자가 명시적으로 브랜딩하는 경우에만 사용합니다.
4GSAP 대체 없이 opacity:0GSAP CDN이 실패하면 사이트 전체가 보이지 않습니다. 빈 페이지.첫 JS 줄: typeof gsap 확인, 정의되지 않은 경우 모든 .reveal-up을 visible로 설정합니다.
5멋진 히어로, 아래는 평범함스크롤에서 "와우"가 사라집니다. 영화 같은 히어로 아래 획일적인 카드.모든 섹션에 동등한 디자인 관심을 기울입니다. 스크롤 여정이 곧 포트폴리오입니다.
6소셜 링크에 href="#"사이트가 분명히 가짜로 보입니다. 신뢰도를 죽입니다.실제 URL을 사용합니다. 제공된 것이 없으면 버튼을 완전히 생략합니다.
7모든 곳에서 동일한 애니메이션 타이밍모든 것이 동일한 속도와 이징으로 움직이면 로봇처럼 느껴집니다.지속 시간을 다양하게 합니다 (0.4초-1.2초). 요소마다 다른 이징. 음수 오프셋으로 스태거합니다.
8pointer-events: none 없는 장식 요소오브, 노이즈, 커서 광택이 아래 콘텐츠의 마우스 클릭을 차단합니다.모든 장식용 고정/절대 요소는 pointer-events: none을 얻습니다.
9그라데이션 배경 위의 그라데이션 텍스트읽을 수 없음. 두 개의 경쟁 그라데이션이 상쇄됩니다.단색/거의 단색의 어두운 배경에서만 그라데이션 텍스트. 시각적 영역당 하나의 그라데이션.
10카드에 cursor: pointer 누락카드가 상호작용적으로 보이지만 커서는 기본값으로 유지됩니다. 사용자 혼란.호버 상태 또는 클릭 핸들러가 있는 모든 요소에 cursor: pointer.
11UI의 이모지 아이콘보편적인 "AI가 만들었습니다" 신호. 디자인 노력 없음.assets/social-icons.svg의 인라인 SVG. 내비게이션, 버튼, 헤더에 이모지 없음.
12width: 100vwWindows에서 스크롤바 너비를 포함하여 가로 오버플로우 발생.width: 100% 또는 본문에 overflow-x: hidden 사용.
13아이콘 5개를 위해 아이콘 라이브러리 로드추가 HTTP 요청, FOUC, ~2KB SVG 경로를 위한 CDN 종속성.HTML에 직접 SVG 인라인. 5-8개의 소셜 아이콘 = ~2KB 인라인.
14일반적인 CTA 텍스트"Let's Connect" / "Get In Touch" — 모든 AI 포트폴리오가 이것들을 사용합니다.개성에 맞추기: "Let's Build Something" (빌더), "Say gm" (암호화폐), "Drop a Line" (캐주얼).
15아바타에 alt 누락접근성 실패. 스크린 리더가 아무것도 알리지 않음.alt="[사용자 이름]" — 간단하고 설명적입니다.
164+ 색상 무지개 그라데이션 텍스트장난감처럼 보입니다. 여러 색상 그라데이션은 거의 작동하지 않습니다.동일 계열의 최대 2-3가지 색상 (분홍 → 보라, 분홍 → 녹색 → 파랑 아님).

필수 애니메이션

구현은 references/animations/gsap-patterns.md를 참조하십시오. 모든 사이트는 다음을 포함해야 합니다:

  1. 히어로 진입 타임라인 — 스태거 .from(): 아바타 (back.out), 배지, 제목 줄, 부제목, 소셜 (back.out 스태거), 스크롤 표시기. 음수 오프셋으로 중첩.
  2. 스크롤 리빌 — .reveal-up 요소가 start: "top 85%"에서 {y:30, opacity:0}에서 애니메이션. 뷰포트 그룹 내에서 스태거.
  3. 통계 카운터 — onUpdate를 통해 0에서 목표까지 애니메이션. 스크롤 시 트리거.
  4. 카드 기울기 — mousemove → 커서 오프셋에서 rotateX/rotateY. transformPerspective: 1000. mouseleave에서 재설정.
  5. 커서 광택 — 600px 방사형 그라데이션이 requestAnimationFrame + 0.08 lerp로 마우스 따라감.
  6. 자기 버튼 — 소셜 버튼이 커서 쪽으로 이동 (0.3x 계수), elastic.out(1, 0.5)로 스냅백.
  7. 시차 배경 — 장식 요소가 scrub: 1로 스크롤 시 이동.
  8. 내비게이션 축소 — 80px 스크롤 깊이에서 .scrolled 클래스 토글.

선택 사항 (테마/콘텐츠 기반 추가):

  • 스크롤 속도 부스트가 있는 마키
  • 문자별 분할 리빌 (사이버펑크/극적)
  • 5개 이상의 프로젝트를 위한 가로 스크롤
  • 호버 시 그라데이션 텍스트 샤이머
  • 왼쪽에서 슬라이드인 섹션 레이블

품질 체크리스트

구조:

  • 3개 파일 모두 생성됨 (index.html, css/style.css, js/main.js)
  • DOCTYPE, charset, viewport, lang 속성 있음
  • 사용자 실제 정보가 포함된 OG 메타 태그
  • :root의 모든 CSS 사용자 정의 속성
  • defer가 있는 GSAP CDN 링크
  • defer가 있는 본문 끝에 JS 연결

콘텐츠:

  • 모든 사용자 데이터 주입됨 (이름, 링크, 프로젝트, 약력)
  • 일반적인 플레이스홀더 없음 ("Lorem ipsum", "Your Name Here")
  • 소셜 링크는 실제 URL 사용, 제공된 링크에 href="#" 없음
  • 푸터에 올바른 이름과 동적 연도

시각:

  • 글꼴 페어링이 Inter, Roboto, Arial 또는 Space Grotesk가 아님 (사용자 지정 제외)
  • 흰색 배경에 보라색 색 구성표 없음
  • UI에 이모지 아이콘 없음
  • 색상 대비가 WCAG AA 충족 (본문 텍스트 4.5:1)
  • 375px, 768px, 1440px에서 반응형 — 가로 스크롤 없음
  • prefers-reduced-motion이 애니메이션 비활성화 및 커서 광택 숨김

기술:

  • GSAP 대체 있음 (typeof 확인 + 불투명도 재설정)
  • 모든 장식 요소에 pointer-events: none
  • CSS에 width: 100vw 없음
  • 모든 상호작용 요소에 cursor: pointer
  • 이미지에 alt 속성
  • 외부 링크에 target="_blank" rel="noopener"

관련 스킬