이력서 웹사이트 빌더
PDF 이력서로 독창적이고 프로덕션 수준의 개인 웹사이트를 구축하세요. 웹사이트는 사용자의 직업, 성격, 디자인 선호도를 반영해야 하며 — 일반적인 템플릿처럼 보이지 않아야 합니다.
디자인 미학 지침
코드를 한 줄이라도 작성하기 전에, 다음을 명심하세요: AI가 생성한 웹사이트의 가장 큰 실패 요인은 **미학적 수렴(Aesthetic Convergence)**입니다 — 모든 사이트가 어렴풋이 비슷해 보입니다. 이는 반드시 피해야 합니다. 당신의 임무는 이 사람을 위해 진정으로, 구체적으로 디자인된 무언가를 만드는 것입니다.
타이포그래피
아름답고, 독특하며, 해당 분야에 적합한 폰트를 선택하세요. 목표는 누군가가 보고 언급할 만한 조합을 만드는 것입니다 — 안전한 대체 폰트가 아닙니다.
사용 금지 폰트 (과도하게 사용되어 눈에 띄지 않음): Inter, Roboto, Arial, Helvetica, system-ui, -apple-system, Space Grotesk, Poppins. 이것들은 선택이 아닌 기본값입니다.
참고할 개성 있는 구글 폰트 (직업과 미학에 맞는 것을 고르세요 — 모두 사용하지는 마세요):
편집적 / 표현적 세리프:
- Cormorant Garamond — 낭만적, 문학적, 패션 편집 럭셔리
- Playfair Display — 고전 인쇄 편집, 고대비 획
- Fraunces — 기발한 광학 세리프, 놀라운 개성
- Instrument Serif — 세련되고 현대적, 조용한 자신감
- DM Serif Display — 힘 있는 현대 세리프
- Abril Fatface — 초고대비, 강렬한 헤드라인
- Yeseva One — 아르데코의 따뜻함, 접근하기 쉬운 권위
- Cinzel — 고전 로마의 위엄
깔끔하지만 개성 있는 산세리프:
- Syne — 기하학적, 디자인 중심, 현대적
- Unbounded — 대담하고, 그리드에 완벽하며, 웹 네이티브
- Plus Jakarta Sans — 따뜻하고 현대적, Inter와 차별화
- Outfit — 신선한 기하학, 개성 있음
- DM Sans — 깔끔하지만 멸균적이지 않음
- Josefin Sans — 우아한 기하학적 미니멀리즘
본문용 (가독성 좋고 개성 있는):
- Lora — 따뜻한 세리프, 문학적, 장문 가독성 좋음
- Source Serif 4 — 편집적 신뢰성
- Spectral — 우아한 디지털 세리프
- Literata — 정밀하게 설계된 읽기 경험
기술 / 개발자 미학:
- JetBrains Mono — 개발자 신뢰성
- IBM Plex Mono — 기업 기술, 구조적
- Space Mono — 레트로 디지털, 개성
- Fira Code — 합자, 해커 미학
표현적 / 틈새 미학:
- Exo 2 — 공상과학 정밀함
- Orbitron — 우주 시대 (절제해서 사용 — 적합한 사람에게는 완벽함)
- Rajdhani — 각진, 기술적 에너지
페어링 원칙: 하나의 디스플레이/헤드라인 폰트와 하나의 본문 폰트를 고르세요. 이 둘은 대비되어야 합니다 — 드라마틱한 세리프 헤드라인과 깔끔한 산세리프 본문, 또는 정확한 모노스페이스 헤드라인과 따뜻한 세리프 본문. 두 폰트의 무게가 비슷한 페어링은 지루합니다.
색상 및 테마
강력하고 응집력 있는 팔레트를 고수하세요. 색상을 고르게 퍼뜨리는 소심한 팔레트는 아마추어처럼 보입니다. 하나의 지배적인 색상 + 하나의 강한 악센트 + 신중한 중성색은 거의 항상 세 개의 동일한 가중치 색상보다 더 강력합니다.
사용 금지 색상 조합 (진부하고 예측 가능):
- 흰색 배경에 보라/바이올렛 그라데이션 (기본 "AI 미학")
- 흰색 배경에 청록 + 산호 (과도하게 사용된 스타트업 팔레트)
- 일반적인 다크 모드: #1a1a1a 배경 + 흰색 텍스트 + 파란색 악센트
- 대비나 긴장감 없는 평평한 파스텔
참고할 개성 있는 팔레트 원형 (정확히 복사하지 말고, 적응시키세요):
- 딥 포레스트
#1a2e1a+ 웜 골드#c9a84c+ 크림#f5f0e8— 유기적 권위 - 미드나잇 네이비
#0d1b2a+ 일렉트릭 시안#00d4ff+ 화이트 — 기술적 정밀함 - 웜 블랙
#1a1208+ 앰버#f59e0b+ 아이보리 — 편집적 따뜻함 - 차콜
#2a2a2a+ 러스트#c0392b+ 오프화이트#fafaf7— 대담한 자신감 - 딥 버건디
#3d0c02+ 샴페인#e8d5b7+ 아이보리 — 학문적 럭셔리 - 니어 블랙
#0e0e0e+ 애시드 라임#a8d729+ 화이트 — 기술적 날카로움 - 슬레이트
#2c3e50+ 딥 코랄#ff6b4a+ 크림 — 따뜻한 모더니즘 - 오프화이트
#fafaf8+ 잉크#1a1a2e+ 테라코타#c4602a— 기반이 있는 따뜻함 - 다크 바이올렛
#1a0533+ 핫 핑크#ff6b9d+ 화이트 — 창의적 맥시멀리즘
다른 사용자에게 라이트 테마와 다크 테마를 능동적으로 번갈아 사용하세요. "더 기술적으로 보인다"고 해서 기본적으로 다크 테마를 선택하지 마세요 — 강력한 편집 팔레트를 가진 라이트 사이트도 그만큼 인상적일 수 있습니다.
모든 색상에 CSS 커스텀 속성을 사용하세요:
:root {
--color-bg: #1a2e1a;
--color-surface: #243824;
--color-accent: #c9a84c;
--color-text: #f5f0e8;
--color-muted: #8a9e8a;
}
모션
잘 짜여진 하나의 진입 시퀀스가 수많은 산만한 미세 상호작용보다 더 큰 즐거움을 만듭니다. 페이지 로드를 하나의 안무된 순간으로 생각하세요.
효과적인 패턴:
/* 로드 시 지연 공개 — 증가하는 animation-delay 적용 */
@keyframes fadeUp {
from { opacity: 0; transform: translateY(24px); }
to { opacity: 1; transform: translateY(0); }
}
.hero-name { animation: fadeUp 0.6s ease forwards; animation-delay: 0.1s; }
.hero-title { animation: fadeUp 0.6s ease forwards; animation-delay: 0.25s; }
.hero-tagline { animation: fadeUp 0.6s ease forwards; animation-delay: 0.4s; }
.hero-cta { animation: fadeUp 0.6s ease forwards; animation-delay: 0.55s; }
opacity: 0을 기본값으로 사용하고opacity: 1로 애니메이션 — 깔끔하고 구성 가능- 호버 상태는
transition: all 0.2s ease사용 — 반응이 빠르게 느껴질 만큼 빠름 - 스크롤 트리거 공개:
IntersectionObserver+ 뷰포트에 진입하는 섹션을 위한 CSS 클래스 토글 사용 - 테두리, 밑줄, 하이라이트: 애니메이션
width또는clip-path변환이 정밀하고 의도적으로 느껴짐
피해야 할 것: particle.js / 캔버스 입자 효과, 과도한 바운싱, 콘텐츠와 충돌하는 패럴랙스, 총 ~1초 이상 콘텐츠 가시성을 지연시키는 애니메이션
배경
단색은 게으른 기본값입니다. 모든 배경은 적어도 하나의 깊이 또는 질감 레이어가 있어야 합니다.
기법:
/* 메시 그라데이션 — 여러 방사형 그라데이션 레이어 */
background:
radial-gradient(ellipse at 20% 50%, rgba(201,168,76,0.15) 0%, transparent 60%),
radial-gradient(ellipse at 80% 20%, rgba(0,212,255,0.08) 0%, transparent 50%),
#0d1b2a;
/* 미세한 그리드 패턴 */
background-image: linear-gradient(rgba(255,255,255,0.03) 1px, transparent 1px),
linear-gradient(90deg, rgba(255,255,255,0.03) 1px, transparent 1px);
background-size: 48px 48px;
/* SVG 필터를 통한 그레인 텍스처 */
filter: url(#grain); /* SVG feTurbulence 필터 정의 */
/* 대각선 스트라이프 악센트 */
background: repeating-linear-gradient(
-45deg,
transparent,
transparent 8px,
rgba(201,168,76,0.05) 8px,
rgba(201,168,76,0.05) 9px
);
배경 기법을 전체 미학과 일치시키세요 — 터미널 미학의 개발자 사이트는 미세한 스캔라인 효과를 사용할 수 있고, 럭셔리 금융 사이트는 매우 희미한 린넨 텍스처를 사용할 수 있습니다.
워크플로
1단계: 이력서 PDF 추출
다음 접근 방식을 순서대로 사용하세요 — 먼저 스크립트를 시도하고, 실패할 경우에만 MCP로 폴백하세요.
옵션 A: uv 스크립트 (권장)
uv를 사용하여 추출 스크립트를 실행하세요. uv가 설치된 것 외에는 설정이 필요 없으며 종속성을 자동으로 처리합니다.
uv run .claude/skills/resume-website/scripts/pdf-extract.py <resume.pdf-경로>
uv가 설치되지 않은 경우, 사용자에게 먼저 설치하도록 안내하세요:
- macOS / Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh - Windows (PowerShell):
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
설치 후, 위 스크립트 명령을 다시 실행하세요.
옵션 B: pdf-reader MCP (폴백)
스크립트가 어떤 이유로든 실패하면 pdf-reader MCP로 폴백하세요. 설치되었는지 확인하고, 설치되지 않았다면 설치하세요:
claude mcp add pdf-reader -- npx @sylphx/pdf-reader-mcp
설치 후, MCP를 사용할 수 있도록 Claude Code를 다시 시작하세요. 그런 다음 MCP의 read_pdf 도구를 사용하여 이력서 콘텐츠를 추출하세요.
2단계: 이력서 읽기 및 분석
pdf-reader MCP를 사용하여 사용자의 이력서 PDF를 읽으세요. 다음을 추출하고 정리하세요:
- 이름 및 연락처 정보 (이메일, 전화번호, 위치, LinkedIn, GitHub, 포트폴리오 링크)
- 전문 직함 / 헤드라인
- 경력 (회사, 직책, 날짜, 성과)
- 학력 (학위, 기관, 날짜)
- 기술 (기술, 소프트 스킬, 언어)
- 프로젝트 (있는 경우)
- 자격증, 수상, 출판물 (있는 경우)
- 요약 / 목표 (있는 경우)
3단계: 사용자의 직업 분석
사용자의 직업이 웹사이트의 미학적 방향을 결정합니다. 표면적인 분류를 넘어 직업적 정체성에 맞게 디자인을 일치시키세요. 헤지펀드의 "소프트웨어 엔지니어"는 디자인 에이전시의 엔지니어와 다른 미학을 가지고 있습니다.
| 직업 카테고리 | 미학적 방향 | 폰트 시작점 | 색상 방향 |
|---|---|---|---|
| 소프트웨어 엔지니어 / 개발자 | 터미널에서 영감, 정밀함, 다크 선호 | JetBrains Mono 또는 IBM Plex Mono + 깔끔한 산세리프 | 어두운 배경 + 일렉트릭 악센트 (시안, 그린, 앰버) |
| 디자이너 / 크리에이티브 디렉터 | 대담함, 실험적, 강력한 타이포그래피 존재감 | 표현적 디스플레이 세리프 + 기하학적 산세리프 | 고대비, 예상치 못한 조합 |
| 데이터 과학자 / 분석가 | 구조화됨, 분석적, 데이터 시각화에서 영감 | 정밀한 산세리프 + 가독성 좋은 세리프 본문 | 딥 네이비/슬레이트 + 날카로운 단일 악센트 |
| 마케팅 / 비즈니스 | 편집 잡지 느낌, 자신감, CTA 중심 | 고대비 세리프 헤드라인 + 따뜻한 산세리프 | 따뜻한 지배색 + 대담한 악센트 |
| 학계 / 연구자 | 학술적, 세리프 중심, 지적 미니멀리즘 | Cormorant 또는 Spectral + Lora 본문 | 크림/아이보리 + 잉크 + 하나의 따뜻한 악센트 |
| 의료 | 깔끔함, 신뢰할 수 있음, 차분한 권위 | DM Sans 또는 Plus Jakarta Sans + 가독성 좋은 본문 | 진정시키는 중성색 + 신뢰할 수 있는 악센트 |
| 금융 / 컨설팅 | 럭셔리, 권위, 세련됨 | Cinzel 또는 Yeseva One + 우아한 본문 세리프 | 어두움 + 골드/샴페인 또는 딥 네이비 + 실버 |
| 아티스트 / 사진작가 | 갤러리 같음, 이미지 중심, 드라마틱함 | Abril Fatface 또는 Syne + 미니멀 본문 | 그들의 작업에 따라 다름 — 종종 니어 블랙 + 하나의 대담한 색상 |
| 제품 관리자 | 현대적, 체계적, 메트릭 중심 | Instrument Serif + 깔끔한 산세리프 | 자신감 있는 중간 톤 + 선명한 악센트 |
| 교사 / 교육자 | 따뜻함, 접근성, 가독성 | Fraunces 또는 DM Serif + 따뜻한 산세리프 본문 | 따뜻한 팔레트, 더 높은 밝기 |
| 법률 | 권위적, 전통적, 구조화됨 | Cinzel 또는 Playfair Display + 세리프 본문 | 딥 네이비 또는 차콜 + 골드 |
| 프리랜서 / 일반 | 개인 브랜드 표현 — 이력서 세부 정보를 사용하여 결정 | 성격에 따라 다름 | 성격에 따라 다름 |
이것을 시작점으로 사용하고, 구체적인 이력서가 그들의 성격, 경력, 산업 맥락에 대해 드러내는 내용에 따라 조정하세요.
4단계: 사용자의 디자인 선호도 묻기
AskUserQuestion 도구를 사용하여 디자인 선호도를 수집하세요. 사용자가 디자인 용어를 모를 수 있으므로 친근하고 비기술적인 방식으로 질문하세요.
핵심 원칙: 각 질문은 사용자가 이미 답변한 내용에 맞게 조정되어야 합니다. 모든 질문을 한꺼번에 배치하고 미리 생성된 옵션을 제시하지 마세요 — 이후 질문의 선택지는 사용자가 이전에 선택한 내용에 따라 달라집니다. 사용자가 라이트/다크를 원하는지 알기 전에 타이포그래피에 대해 묻는다면, 잘못된 폰트를 제안하게 될 것입니다.
1라운드 — 앵커 결정: 분위기 + 톤
전반적인 분위기와 라이트/다크 방향을 함께 물어보세요. 이것은 다른 모든 것이 분기되는 두 가지 축이기 때문입니다. 직업에 맞게 조정된 3-4개의 미학적 방향을 생성하세요 (예: 소프트웨어 엔지니어는 "터미널/정밀함", 디자이너는 "편집/표현적"을 봄). 최고 추천을 먼저 제시하고 왜 그들이 특별히 적합한지 설명하세요. "놀라게 해줘" 옵션을 포함하세요.
답변을 받으면, 이것을 이후 모든 것의 앵커로 유지하세요.
2라운드 — 색상 + 시각적 스타일 (1라운드에 맞게 조정)
이제 사용자가 선택한 테마 내에서 실제로 작동하는 색상 팔레트 옵션을 생성하세요. 라이트를 선택했다면 라이트 팔레트를 보여주세요 — "5가지 옵션이 있고 그중 3개는 다크입니다"가 아니라요. 시각적 스타일도 마찬가지로, 사용자가 선택한 분위기와 일관된 스타일을 보여주세요. 디자인 미학 지침의 팔레트 원형을 시작점으로 사용하고 이를 적응시키세요.
색상을 시각적으로 보여주기: 색상 질문을 하기 전에 임시 color_preview.html 파일을 생성하고 브라우저에서 열어 사용자가 실제 견본을 볼 수 있게 하세요. 그런 다음 사용자에게 이름/번호로 선택하도록 요청하세요.
3-4개의 팔레트 옵션을 생성하세요. 각 팔레트는 배경, 표면, 악센트, 텍스트 색상을 가져야 합니다. HTML을 다음과 같이 작성하세요:
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>팔레트 선택</title>
<style>
body { font-family: sans-serif; padding: 32px; background: #f5f5f5; }
.palettes { display: flex; flex-wrap: wrap; gap: 24px; }
.palette { border-radius: 12px; overflow: hidden; width: 260px; box-shadow: 0 2px 12px rgba(0,0,0,0.12); }
.swatch { height: 56px; display: flex; align-items: center; padding: 0 16px; font-size: 13px; font-weight: 500; }
.label { padding: 14px 16px; background: white; }
.label h3 { margin: 0 0 4px; font-size: 15px; }
.label p { margin: 0; font-size: 12px; color: #666; }
</style>
</head>
<body>
<h2>색상 팔레트를 선택하세요</h2>
<div class="palettes">
<!-- 각 팔레트 옵션에 대해 이 블록을 반복 -->
<div class="palette">
<div class="swatch" style="background:#1a2e1a; color:#f5f0e8;">배경</div>
<div class="swatch" style="background:#243824; color:#f5f0e8;">표면</div>
<div class="swatch" style="background:#c9a84c; color:#1a2e1a;">악센트</div>
<div class="swatch" style="background:#f5f0e8; color:#1a2e1a;">텍스트</div>
<div class="label">
<h3>1. 포레스트 & 골드</h3>
<p>유기적 권위 — 딥 그린, 웜 골드, 크림</p>
</div>
</div>
</div>
</body>
</html>
현재 디렉토리에 color_preview.html로 저장한 다음 open color_preview.html을 실행하세요. 사용자에게 "브라우저에서 색상 미리보기를 열었습니다 — 살펴보시고 마음에 드는 팔레트 번호를 알려주세요."라고 말하세요.
사용자가 선택한 후에는 color_preview.html을 삭제하고 계속 진행하세요.
3라운드 — 타이포그래피 + 폰트 페어링
직업과 선택한 색상 팔레트에 맞게 조정된 폰트 페어링 옵션을 제공하세요. 앞서 질문한 질문을 반복하지 마세요. 3-4개의 구체적인 폰트 조합을 제안하고 각각이 왜 사용자에게 적합한지 설명하세요. 직관적인 미리보기를 원하는 사용자를 위해 폰트 미리보기 HTML 페이지를 생성하는 것을 고려하세요.
모든 선택이 완료되면 질문을 중단하세요. 사용자가 "팔레트 1이 좋습니다"라고 말하면, 그 팔레트 색상을 사용하여 계속 진행하고 더 이상 색상 질문을 하지 마세요.
5단계: 디자인 선호도 저장
모든 선호도를 추출된 이력서 데이터와 함께 /tmp/resume-content.json에 저장하세요. 이 파일을 나중 웹사이트 생성의 유일한 입력으로 사용하세요.
{
"resume": { ... },
"preferences": {
"vibe": "terminal-precision",
"theme": "dark",
"colors": {
"--color-bg": "#0d1b2a",
"--color-surface": "#14243a",
"--color-accent": "#00d4ff",
"--color-text": "#ffffff"
},
"fonts": {
"heading": "JetBrains Mono",
"body": "IBM Plex Sans"
}
}
}
6단계: 웹사이트 생성
단일 index.html 파일을 생성하세요. 외부 리소스 번들링은 허용되지 않습니다 — Google Fonts 및 Font Awesome(Icons 사용 시)을 제외한 모든 것은 인라인 처리되어야 합니다.
스크립트, 스타일시트, 리소스:
- CSS: 단일
<style>블록에 모두 포함 - JavaScript: 단일
<script>블록에 모두 포함 (가능하면 작게 유지) - Google Fonts:
<link>태그를 통해 로드 - 아이콘: Font Awesome을 CDN에서 로드하거나, 간단한 SVG 인라인 아이콘 자체 생성
- 이미지: 인라인 또는 외부 소스. 이력서에 GitHub 프로필 사진 URL이 있으면 사용. 없으면, UI 아바타 API를 사용하여 이니셜 기반 아바타를 생성하세요.
레이아웃 섹션:
- 히어로 — 이름, 직함, 한 줄 설명, 클릭 가능한 CTA 버튼 (연락처, GitHub 등)
- 경력 — 타임라인 또는 카드 기반 경험 목록, 각 역할은 회사, 직함, 날짜, 성과를 포함
- 기술 — 그리드 또는 태그 목록, 기술 그룹별로 분류
- 프로젝트 (있는 경우) — 각 프로젝트에 대한 카드 (이름, 설명, 링크)
- 학력 — 간결하고 깔끔한
- 연락처 — 바닥글 또는 섹션, 모든 연락처 링크
반응형: 미디어 쿼리를 사용하여 모바일, 태블릿, 데스크톱 뷰포트에서 완벽하게 작동해야 합니다.
성능:
- 파일 크기를 가능한 작게 유지
- 읽기 힘든 미니파이된 코드를 생성하지 마세요 — 깔끔하고 들여쓰기된 HTML을 내보내세요
- 타사 스크립트를 무분별하게 추가하지 마세요 — Google Analytics나 Hotjar를 절대 포함하지 마세요
7단계: 웹사이트 열기 및 확인
open index.html을 실행하거나 VS Code 라이브 서버 확장을 사용하여 사이트를 미리보세요.
검증 체크리스트:
- 모든 섹션이 표시됩니까?
- 폰트가 올바르게 로드됩니까? (네트워크 탭 확인)
- 색상이 지정된 팔레트와 일치합니까?
- 애니메이션이 부드럽게 작동합니까? (느리거나 끊기지 않음)
- 반응형입니까? (모바일, 태블릿, 데스크톱에서 확인)
- 모든 링크가 작동합니까?
- 전체적으로 독특하고 디자인된 느낌이 듭니까?
8단계: 피드백을 위한 표시
사용자에게 사이트를 제시하세요. 브라우저에서 이미 열려 있어야 하지만, 사이트 파일의 위치를 명확히 알려주세요:
"여기 당신의 개인 웹사이트가 있습니다! index.html에 위치해 있습니다. 브라우저에서 볼 수 있어야 합니다. 마음에 드는 점과 변경하고 싶은 점을 알려주세요."
사용자가 피드백을 제공하면:
- 디자인에 대한 구체적인 변경 요청을 구현하세요 ("하단에 연락처가 있는 바닥글을 추가해 주세요", "직함 아래에 파란색 밑줄을 넣어 주세요" 등)
- "조금 더 생생하게"나 "더 전문적으로 보이게"와 같은 모호한 요청은 명확한 디자인 행동으로 해석하세요 — 요청을 무시하거나 불가능하다고 말하지 마세요
- 변경 후
open index.html을 사용하여 브라우저 탭을 새로고침하세요
유지보수 / 버그
추출 스크립트를 실행한 후 uv 관련 오류가 발생하면: 사용자에게 uv가 설치되어 있는지 확인하세요. 설치 세부 정보는 1단계를 참조하세요.
MCP가 실패하면: MCP가 올바르게 설치되었고 claude mcp list로 찾을 수 있는지 확인하세요. "No tools found"가 표시되면 Claude Code를 다시 시작한 후 pdf-reader MCP를 다시 추가하세요.
/tmp/resume-content.json을 찾을 수 없으면: 5단계로 돌아가서 질문을 다시 하고 파일을 다시 생성하세요.