SKILL.md — 개인 포트폴리오 및 이력서 웹사이트
목표
창의적인 전문가를 위한 단일 페이지, 다크 테마 개인 포트폴리오 / 온라인 이력서를 구축합니다. 참고 디자인과 일치하도록: 영화 같은 히어로, '소개' 분할 섹션, 3열 '이력서' 섹션, '포트폴리오' 갤러리로 구성됩니다. 차분하고, 고급스럽고, 고대비이며, 하나의 시안 악센트 색상만 사용합니다.
사이트는 100% 데이터 기반입니다: 모든 텍스트 조각, 모든 기술 수준, 모든 이미지 경로는 js/config.js에 저장됩니다. 콘텐츠를 편집할 때 HTML이나 CSS를 건드릴 필요가 없습니다.
기술 스택 (엄격한 규칙)
- Vanilla HTML5 + CSS3 + JavaScript만 사용. npm, 번들러, 프레임워크, 빌드 단계 없음.
- 외부 라이브러리는 CDN 전용으로만 사용. 허용되는 것:
- Google Fonts → Montserrat (굵기 300, 400, 500, 600, 700, 800, 900)
- Font Awesome 6 (무료 CDN) — 모든 아이콘 (내비게이션, 소셜, 소프트웨어 배지, 취미)
- GSAP 3 + ScrollTrigger (CDN) — 스크롤 애니메이션
- 모든 콘텐츠는
js/config.js의 단일CONFIG객체에 저장됩니다. - 사이트는
index.html을 더블클릭하여 열 수 있어야 하며 (서버 불필요), cPanel 애드온 도메인에서 호스팅될 때도 정상 작동해야 합니다.
콘텐츠 소스 (먼저 읽으세요)
무엇이든 생성하기 전에, Claude Code는 다음을 수행해야 합니다:
-
프로젝트 루트의
README.md를 읽습니다. 여기에는 소유자의 실제 개인 정보가 포함되어 있습니다: 전체 이름, 직함, 태그라인, 약력, 이메일, 전화번호, 주소/도시, 소셜 링크, 소프트웨어 기술 + 수준, 언어 + 수준, 개인 기술, 경력 (연도 범위 + 회사 + 역할), 교육, '내가 할 수 있는 일' 서비스, 디자인 기술, 취미.js/config.js를 이 README에서 완전히 채웁니다. README에 필드가 누락된 경우,config.js에 명확히 표시된""플레이스홀더를 남깁니다 (가짜 데이터를 절대 만들지 마십시오). -
프로젝트에서 이미지를 스캔합니다 (루트 및/또는
assets/img/):- 초상화 사진 → 소개 섹션 및 히어로 이름 블록 배경 참조로 사용됩니다.
- 히어로/책상 배경 이미지 → 홈 배경으로 사용됩니다.
- 나머지 모든 프로젝트 이미지 → 포트폴리오 그리드로 사용됩니다.
존재하는 파일 이름을
config.js에 매핑합니다. HTML에 경로를 하드코딩하지 마십시오.
파일 구조
portfolio/
├── README.md # 소유자 정보 (콘텐츠 소스) — 사용자 제공
├── SKILL.md # 이 파일
├── index.html
├── css/
│ └── style.css
├── js/
│ ├── config.js # 모든 편집 가능한 콘텐츠가 여기에 있습니다.
│ └── main.js # 내비게이션, 부드러운 스크롤, GSAP 애니메이션, 진행 표시줄 채우기
└── assets/
└── img/
├── profile.jpg # 초상화 (소개)
├── hero-bg.jpg # 히어로 배경
└── portfolio/ # 프로젝트 이미지 (갤러리)
디자인 시스템
색상 (CSS 변수, :root에 정의)
--bg-hero: #0A0A0C; /* 거의 검정, 사진 뒤 히어로 베이스 */
--bg-about: #0B0B0E; /* 소개 섹션, 거의 순수 검정 */
--bg-resume: #11141F; /* 이력서 섹션, 진한 네이비 챠콜 */
--bg-resume-grad: linear-gradient(160deg, #141826 0%, #0E111B 100%);
--accent: #2EA9E0; /* 단일 시안-파랑 악센트 */
--accent-soft: rgba(46,169,224,0.18);
--text-primary: #FFFFFF; /* 제목, 이름 */
--text-secondary: #C2C6CE; /* 본문 */
--text-muted: #8A8F99; /* 하위 레이블, 캡션 */
--line: rgba(255,255,255,0.12); /* 진행 트랙, 구분선 */
--overlay: linear-gradient(90deg, rgba(0,0,0,0.85) 0%, rgba(0,0,0,0.35) 60%, rgba(0,0,0,0.7) 100%);
악센트는 다음에만 사용됩니다: 활성 내비게이션 링크, 제목 밑줄, 타임라인 점, 진행 표시줄 채우기 + 마커 점, 링크 호버. 드물게 사용하십시오.
타이포그래피
- 폰트 패밀리: Montserrat 전체에 사용.
- 이름 (히어로): 두 줄 — 이름은
font-weight:300+ 대문자, 성은font-weight:900대문자, ~clamp(48px, 7vw, 84px), 좁은 줄 간격. - 이름 아래 직함:
font-weight:400, 대문자,letter-spacing:0.45em,--text-muted, ~14px. - 섹션 제목 (
ABOUT,SOFTWARE SKILLS등):font-weight:800, 대문자, ~18–26px, 흰색, 짧은 시안 밑줄 포함 (약 48px 너비, 3px 높이, 악센트 색상, 텍스트 바로 아래 위치). - 본문:
font-weight:400, 15px,--text-secondary, 줄 간격 1.7.
간격 및 레이아웃
- 각 주요 섹션 (홈, 소개, 이력서)은 데스크탑에서 전체 뷰포트 높이 (
min-height:100vh), 수직으로 쌓이며, 스크롤 스냅은 선택 사항입니다. - 콘텐츠 최대 너비 ~1240px, 가운데 정렬, 넉넉한 측면 패딩 (clamp 24px–80px).
- 각 섹션의 오른쪽 하단 모서리에 작은 전체 화면 / 확장 아이콘이 있습니다 (장식용;
fa-expand), 참고 디자인과 일치.
섹션
1. 상단 내비게이션 (고정 / 섹션별)
- 왼쪽: 링크
Home · About · Resume · Portfolio(font-weight:500, 흰색). 활성 링크 =--accent. 해당 섹션으로 부드럽게 스크롤. - 오른쪽: 전화 아이콘 (
fa-phone) + config의 전화 번호, 흰색, ~13px. - 히어로 위에서는 투명 배경; 다른 섹션 위에서는 미묘한 어두운 막대.
- 768px 미만에서는 햄버거 메뉴로 축소.
2. 홈 / 히어로
- 전체 화면 배경 이미지 (
config.hero.background) 위에--overlay그라데이션이 있어 가독성을 높입니다 (콘텐츠는 왼쪽에 표시). - 왼쪽 정렬 콘텐츠 블록, 세로 중앙 정렬:
- 이름 (위에서 설명한 두 가지 굵기 처리).
- 직함 (자간 넓은 대문자).
- 두 개의 테두리 있는 알약 버튼:
Resume및Portfolio(1px 흰색 테두리, 투명 채우기, 전체 둥근 모서리, 호버 → 채우기--accent, 테두리--accent). 각각 해당 섹션으로 스크롤.
- 왼쪽 아래: 소셜 아이콘 행 (Behance, Facebook, LinkedIn, Instagram, Pinterest, Twitter/X, WhatsApp) (
config.social에서 가져옴) — URL이 있는 것만 렌더링. 흰색 아이콘, 호버 →--accent. - 오른쪽 아래: 확장 아이콘.
3. 소개
- 두 열 분할: 왼쪽은 텍스트, 오른쪽은 큰 흑백 초상화 (
config.about.photo,filter:grayscale(100%)적용, 마스크/그라데이션을 통해 왼쪽 가장자리가 검은 배경으로 페이드 아웃). - 왼쪽 열:
ABOUT제목 + 시안 밑줄.- 이메일 줄 (
config.contact.email),--text-muted. - 약력 단락 (
config.about.bio),--text-secondary. - 아래: 위치 — 도시 줄 + 거리 줄, 가운데 정렬, 각 측면에 짧은 대시/선으로 둘러싸임 (
— Florida, Orlando —스타일) (config.contact.location사용).
4. 이력서 (3열)
데스크탑에서는 3개의 동일한 열; 모바일에서는 1열로 쌓임.
열 A — 기술 및 언어
SOFTWARE SKILLS:config.skills.software의 각 항목에 대해, 행을 렌더링: 정사각형 둥근 아이콘 배지 (1px 테두리, 도구의 글자 또는 Font Awesome 브랜드 아이콘) + 레이블 + 수평 진행 트랙 (채워진 부분과level%(0–100) 위치에 시안 마커 점 포함). 트랙 =--line, 채우기 + 점 =--accent.LANGUAGES: 레이블 + 동일한 진행 트랙 처리 (config.skills.languages).PERSONAL SKILLS: 쉼표/대시로 연결된 키워드의 한 줄 (config.skills.personal),--text-secondary.
열 B — 경험 및 교육
EXPERIENCE: 수직 타임라인. 각 항목 = 원형 연도 배지 (config.experience[].years, 예:2017 till present, 악센트 채우기, 작은 흰색 텍스트)가 수직선으로 연결됨, 옆에 회사 이름 (굵게, 대문자) + 그 아래 역할 (--text-muted).config.experience를 반복.EDUCATION: 학위 (굵게) + 그 아래 기관 (config.education).
열 C — 서비스, 디자인 기술, 취미
WHAT CAN I DO ?: 대시로 연결된 서비스 (config.services) 줄.DESIGN SKILLS: 대시로 연결된 강점 (config.designSkills) 줄.HOBBIES & INTERESTS: 원형 테두리 아이콘 (1px 테두리 원, 내부 Font Awesome 아이콘)의 2열 그리드 + 각 아이콘 아래 캡션 (config.hobbies, 예: 독서, 사진, 그림, 여행).
5. 포트폴리오
- 반응형 그리드 갤러리 (CSS 그리드, ~데스크탑 3열 / 태블릿 2열 / 모바일 1열,
gap:16px) (config.portfolio[]에서 빌드, 각 항목: 이미지 경로, 선택적 제목, 선택적 링크). - 각 타일: 이미지 cover-fit, 호버 시 어두운 오버레이가 나타나 흰색 제목 + 시안 악센트 라인 공개. 미묘한 확대 효과.
config.portfolio가 비어 있으면 섹션을 우아하게 숨깁니다.
config.js 모양 (Claude Code: README + 이미지에서 채우기)
const CONFIG = {
identity: {
firstName: "",
lastName: "",
title: "", // 예: "Full Stack Developer"
},
contact: {
phone: "",
email: "",
location: { city: "", street: "" },
},
social: { // 아이콘을 숨기려면 생략 / ""로 남김
behance: "", facebook: "", linkedin: "", instagram: "",
pinterest: "", twitter: "", whatsapp: "",
},
hero: { background: "assets/img/hero-bg.jpg" },
about: {
photo: "assets/img/profile.jpg",
bio: "",
},
skills: {
software: [ // level: 0–100
{ name: "", icon: "Ps", level: 90 },
],
languages: [
{ name: "", level: 90 },
],
personal: "", // "Creativity - Team Work - Organisation"
},
experience: [
{ years: "", company: "", role: "" },
],
education: [
{ degree: "", school: "" },
],
services: [], // "Logo - Stationery - Branding"
designSkills: [], // "Creativity - Planning & Strategy"
hobbies: [
{ name: "", icon: "fa-book" }, // Font Awesome 아이콘 이름
],
portfolio: [
{ image: "assets/img/portfolio/p1.jpg", title: "", link: "" },
],
};
애니메이션 (GSAP + ScrollTrigger)
- 히어로: 이름 + 버튼이 로드 시 페이드/슬라이드 업 (지연).
- 섹션 제목 + 밑줄: 스크롤하여 보일 때 나타남.
- 이력서 진행 표시줄: 열이 뷰포트에 들어올 때 0에서
level%까지 채우기 + 점 애니메이션. - 타임라인 항목: 스크롤될 때 지연되어 페이드 인.
- 포트폴리오 타일: 미묘한 페이드 업 지연.
- 세련되게 유지 — 짧은 지속 시간 (0.4–0.8초),
power2.out이징.prefers-reduced-motion준수 (애니메이션 비활성화, 최종 상태 표시).
반응형
- ≥ 992px: 전체 레이아웃 (3열 이력서, 분할 소개).
- 768–991px: 이력서 → 2열, 소개 사진 축소.
- < 768px: 모든 것이 1열로 쌓임, 내비게이션이 햄버거 메뉴로 변경, 히어로 텍스트 크기 축소, 고정 배경 → 스크롤 (
background-attachment:scroll) (모바일 버그 방지).
완료 조건
-
index.html이 더블클릭으로 올바르게 열림 (서버 불필요). - 네 개의 내비게이션 링크가 모두 해당 섹션으로 부드럽게 스크롤됨; 스크롤 시 활성 링크가 강조 표시됨.
- 모든 텍스트/이미지/기술 값이
config.js에서 가져옴 (HTML에 하드코딩된 콘텐츠 없음). -
config.js가 프로젝트의README.md에서 채워졌으며, 누락된 항목은""플레이스홀더로 표시됨 (가짜 데이터 없음). - 초상화 + 히어로 + 포트폴리오 이미지가 프로젝트의 이미지 파일에서 연결됨.
- 다크 테마 + 단일 시안 악센트가 참고 디자인과 일치; Montserrat 로드됨.
- 최소 ~360px 너비까지 완전히 반응형.
- GSAP 애니메이션이 있고
prefers-reduced-motion을 준수함.