SKILL.md — Portfolio Builder
사람들이 당신을 기억하게 만드는 개인 포트폴리오를 만드세요. 67개 이상의 UI 스타일, 161개의 색상 팔레트, 57개의 글꼴 페어링, 그리고 포트폴리오 특화 패턴이 뒷받침합니다. 파이프라인: 이해 → 브랜드 아이덴티티 → 콘텐츠 → 구축 → 배포.
개요
포트폴리오의 임무는 단 하나입니다. 누군가가 당신과 함께 일하고 싶게 만드는 것입니다. 디자인, 카피, 프로젝트 선정, 인터랙션 등 모든 것이 그 목표를 위해 존재합니다.
파이프라인 (5단계):
Phase 0 — 이해 → 당신은 누구인가? 무엇을 하는가? 누가 이걸 보는가?
Phase 1 — 디자인 → 비주얼 아이덴티티: 스타일, 팔레트, 글꼴 — 작업물의 "느낌"
Phase 2 — 콘텐츠 → 자기소개, 프로젝트 설명, 스킬, 연락처
Phase 3 — 구축 → HTML/CSS + 인터랙티브 프로젝트 그리드 + 애니메이션
Phase 4 — 전달 → 라이브 미리보기 → Vercel 배포
포트폴리오 유형
| 유형 | 대상 | 초점 |
|---|---|---|
| 디자이너 | 클라이언트, 채용 관리자 | 시각 작업, 사례 연구, 프로세스 |
| 개발자 | 리크루터, 클라이언트, 협업자 | 프로젝트, 기술 스택, GitHub |
| 크리에이티브 (사진작가/일러스트레이터 등) | 클라이언트, 갤러리 | 전체 너비 이미지, 최소한의 텍스트 |
| 프리랜서 | 잠재 클라이언트 | 서비스, 작업 내역, 연락처/CTA |
| 학생 / 커리어 체인저 | 리크루터, 채용 관리자 | 프로젝트, 스킬, 성장 스토리 |
기술 스택
기본: HTML + CSS + Vanilla JS — 랜딩 페이지와 동일. 프레임워크 불필요.
- 구축 및 배포가 가장 빠름
- 종속성 없음, 애니메이션에 대한 최대 제어
- Vercel이 정적 파일로 즉시 배포
파일 구조
portfolio/
├── index.html # 메인 페이지 (단일 페이지 또는 앵커 내비게이션)
├── styles.css # 디자인 토큰 → 리셋 → 레이아웃 → 컴포넌트 → 섹션 → 애니메이션
├── main.js # 필터, 라이트박스, 스크롤 효과, 모바일 내비게이션
├── assets/
│ ├── images/ # 프로젝트 스크린샷, 아바타, OG 이미지
│ └── fonts/ # 자체 호스팅 폰트 (선택 사항)
└── README.md
Phase 0 — 이해
0.1 핵심 질문
| 질문 | 중요한 이유 |
|---|---|
| 무엇을 하나요? | 디자이너 / 개발자 / 사진작가 / 프리랜서 / 학생 / 복합 |
| 누가 이 페이지를 방문하나요? | 리크루터, 클라이언트, 협업자, 갤러리 큐레이터 |
| 최우선 목표는 무엇인가요? | 취업 / 프리랜서 클라이언트 확보 / 프로그램 입학 / 존재감 확보 |
| 보여줄 프로젝트는 몇 개인가요? | 3~6개가 이상적; 양보다 질 |
| 이미 브랜드가 있나요? | 기존 색상, 글꼴, 로고 — 또는 새로 시작 |
| 톤은요? | 미니멀, 대담, 어둡고, 장난기, 에디토리얼, 테크니컬, 럭셔리 |
| 참고할 포트폴리오가 있나요? | 좋아하거나 차별화하고 싶은 사이트 |
0.2 포트폴리오 아키타입 매핑
| 아키타입 | 주요 섹션 | 시각적 우선순위 |
|---|---|---|
| 디자이너 | 히어로 + 선정 작업 (사례 연구) + 소개 + 스킬 + 연락처 | 사례 연구 디테일, 프로세스 샷 |
| 개발자 | 히어로 + 프로젝트 (라이브 링크 + GitHub) + 스킬/스택 + 소개 + 연락처 | 코드 스니펫, 라이브 데모, GitHub 통계 |
| 크리에이티브 | 전체 너비 히어로 + 갤러리/그리드 + 소개 + 연락처 | 이미지 중심, 최소한의 UI 크롬 |
| 프리랜서 | 히어로 + 서비스 + 작업 + 사용후기 + 연락처 | CTA 두드러짐, 신뢰 신호 |
| 학생 | 히어로 + 프로젝트 + 스킬 + 소개 + 연락처 | 성장 스토리 — 성장과 잠재력 |
Phase 1 — 디자인 리서치
1.1 디자인 데이터베이스
# 스타일 검색
python3 src/ui-ux-pro-max/scripts/search.py "<쿼리>" --domain style --max-results 5
# 색상 팔레트
python3 src/ui-ux-pro-max/scripts/search.py "<분위기/산업>" --domain color --max-results 5
# 타이포그래피
python3 src/ui-ux-pro-max/scripts/search.py "<스타일/분위기>" --domain typography --max-results 3
# 포트폴리오 특화 패턴
python3 src/ui-ux-pro-max/scripts/search.py "portfolio" --domain landing --max-results 5
# 개인 사이트를 위한 제품 유형 규칙
python3 src/ui-ux-pro-max/scripts/search.py "portfolio personal site" --domain product
# 전체 디자인 시스템
python3 src/ui-ux-pro-max/scripts/search.py "<쿼리>" --design-system -p "Portfolio"
# 스택별 스니펫
python3 src/ui-ux-pro-max/scripts/search.py "<쿼리>" --stack html
1.2 포트폴리오 특화 미학 원칙
포트폴리오 자체가 디자인 작업입니다. 평범해 보이면, 작업도 평범하다고 여겨집니다.
| ❌ 평범함 (피할 것) | ✅ 독창적임 (목표) |
|---|---|
| 흰 배경, Inter 폰트, 회색 텍스트 | 개성을 표현하는 팔레트 |
| "안녕하세요, 저는 [이름]입니다. 디자이너입니다." 히어로 | 궁금증을 유발하는 오프닝 라인 |
| 동일한 패딩의 3열 카드 그리드 | 작업의 성격을 반영하는 레이아웃 |
| 호버: 불투명도 0.8 | 호버: 개성 있게 프로젝트 정보 공개 |
| 푸터: "© 2024 이름. All rights reserved." | 브랜드의 연장선인 푸터 |
1.3 포트폴리오를 위한 색상 전략
랜딩 페이지(강조색 = CTA)와 달리, 포트폴리오 색상은 개성을 표현합니다:
| 페르소나 | 팔레트 방향 |
|---|---|
| 미니멀리스트 디자이너 | 거의 흰색 + 강한 강조색 하나, 넉넉한 여백 |
| 대담한 크리에이티브 | 어두운 배경 + 생생한 강조색, 높은 대비 |
| 테크니컬 개발자 | 어두운/터미널 미학 또는 코드에서 영감을 받은 강조색이 있는 깔끔한 밝은 스타일 |
| 따뜻한 프리랜서 | 흙빛 톤, 친근함, 인간적인 느낌 |
| 럭셔리/프리미엄 | 깊은 중성색 + 골드/샴페인, 세련된 타이포그래피 |
1.4 포트폴리오를 위한 디자인 브리프
## Portfolio Design Brief: <이름>
### Identity
- **Who:** <이름 + 역할>
- **Archetype:** <디자이너 / 개발자 / 크리에이티브 / 프리랜서 / 학생>
- **Portfolio goal:** <취업 / 클라이언트 확보 / 존재감 확보>
- **Target viewer:** <리크루터 / 클라이언트 / 협업자>
### Personality (형용사 3개 선택)
- <예: 정확함, 따뜻함, 대담함>
### Style Direction
- **Primary style:** <검색 결과 — 예: "Dark Editorial", "Soft Minimalism">
- **One-word aesthetic:** <예: "focused", "expressive", "technical">
- **Why this style fits the work:** <한 문장>
### Color Palette
- **Background:** <hex> — <이름>
- **Background secondary:** <hex> — 카드/패널용
- **Text primary:** <hex>
- **Text muted:** <hex>
- **Accent:** <hex> — 아껴서 사용, 최대 효과
- **Border/divider:** <hex>
### Typography
- **Heading font:** <이름> + 두께 + Google Fonts URL
- **Body font:** <이름> + Google Fonts URL
- **Heading style note:** <예: "좁은 자간, 큰 스케일 대비">
### Layout Pattern
- **Grid:** <예: 비대칭 2열, masonry, 전체 너비 행>
- **Project card style:** <예: 호버 오버레이가 있는 이미지 우선, 미니멀 텍스트 카드>
- **Section transitions:** <예: 전체 너비 구분선, 계단식 등장, 없음>
### Interactions
- **Project card hover:** <예: 확대 + 제목/태그가 있는 오버레이>
- **Scroll animations:** <예: 작업 그리드에 계단식 페이드업>
- **Cursor:** <기본 / 커스텀 도트 / 없음>
1.5 품질 기준
- 아키타입 식별, 주요 목표 명확
- 결정 전 3개 이상의 스타일 옵션 검색
- 팔레트가 개성을 표현함 (단순히 "깔끔한" 기본값이 아님)
- 글꼴 페어링에 대비가 있음 — 디스플레이용 하나, 본문용 하나
- 레이아웃 패턴이 작업 유형과 일치함 (사진 ≠ 코드 프로젝트)
- 사용자가 디자인 브리지를 승인함
Phase 2 — 콘텐츠
2.1 히어로 카피
히어로 오프닝 라인은 페이지에서 가장 중요한 텍스트입니다. 당신이 누구인지, 무엇을 하는지, 그리고 그것이 왜 중요한지를 개성 있게 답해야 합니다.
공식 옵션:
| 공식 | 예시 |
|---|---|
| 역할 + 차별점 | "0.1초의 순간에 집착하는 프로덕트 디자이너" |
| 결과 우선 | "복잡한 소프트웨어를 간단하게 만듭니다" |
| 대담한 선언 | "좋은 디자인은 보이지 않습니다. 위대한 디자인은 불가피합니다." |
| 장난기/직설적 | "웹용 무언가를 만듭니다. 현재 구직 중입니다." |
| 이름 + 설명 | "안녕하세요, Maya입니다. 저는 인간을 위해 디자인합니다, 화면이 아니라" |
피해야 할 것:
- "저는 5년 경력의 열정적인 디자이너입니다"
- "제 포트폴리오에 오신 것을 환영합니다"
- 일반적인 형용사: 창의적인, 혁신적인, 헌신적인, 열정적인
2.2 프로젝트 설명
각 프로젝트 항목에는 다음이 필요합니다:
### <프로젝트 이름>
**Role:** <당신의 역할 — 예: "리드 디자이너", "솔로 개발자">
**Type:** <예: "모바일 앱", "브랜드 아이덴티티", "웹 앱">
**Tags:** [<기술/스킬 태그>]
**The challenge:** <1-2문장 — 해결해야 할 문제>
**What I did:** <2-3문장 — 당신의 구체적인 기여와 결정>
**The outcome:** <가능하면 결과를 포함한 1문장 — "온보딩 시간 40% 단축">
[Live →](<url>) [Case Study →](<url>) [GitHub →](<url>)
규칙:
- 기술이 아닌 문제로 시작하세요
- 당신의 역할은 구체적이어야 합니다 — "디자이너"는 역할이 아니며, "온보딩 플로우를 설계함"이 역할입니다
- 측정 가능한 지표가 있다면 사용하세요. 없다면 질적 결과를 설명하세요
- 최대 3~6개 프로젝트 — 무자비하게 선별하세요
2.3 소개 섹션
구조:
- 당신은 누구인가 — 현재 상태 (역할, 위치, 집중하는 분야)
- 어떻게 여기까지 왔는가 — 간략한 과정 (이력서가 아닌, 이야기)
- 무엇에 관심을 두는가 — 작업 뒤에 있는 "이유"
- 무엇을 찾고 있는가 — 구직 중 / 특정 프로젝트 유형 / 협업
분량: 80~150단어. 약력이나 이력서가 아닌, 한 사람의 이야기입니다.
2.4 스킬 / 스택 섹션
디자이너용:
Design: Figma, Prototyping, Design Systems, Typography, Motion
Research: User Interviews, Usability Testing, Competitive Analysis
개발자용:
Frontend: React, TypeScript, Next.js, CSS/Tailwind
Backend: Node.js, PostgreSQL, REST/GraphQL
Tools: Git, Docker, Vercel, Figma
태그 클라우드, 아이콘 그리드 또는 그룹화된 목록으로 표시하세요. 일반 글머리 기호 목록은 절대 안 됩니다.
2.5 연락처 섹션
매우 간단하게 유지하세요:
- 이메일 (가장 중요 —
mailto:로 클릭 가능하게 만드세요) - 소셜 링크 2~3개 (GitHub, LinkedIn, Twitter/X, Dribbble — 관련 있는 것 선택)
- 선택 사항: 짧은 "현재 ~ 가능합니다" 한 줄
- 선택 사항: 간단한 문의 양식 (Formspree)
필드가 6개인 문의 양식은 안 됩니다. "커피나 한잔하며 이야기해요" 같은 빈말은 넣지 마세요.
2.6 품질 기준
- 히어로 오프닝 라인에 개성이 있음 (일반적이지 않음)
- 각 프로젝트가 기술이 아닌 문제로 시작함
- 역할이 구체적이며, 단순한 직함이 아님
- 소개 섹션이 실제 사람이 쓴 것처럼 읽힘
- 3~6개 프로젝트, 품질에 따라 선별됨
- 연락처 섹션에 기본 행동으로
mailto링크가 있음
Phase 3 — 구축
3.1 HTML 구조
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title><Name> — <Role></title>
<meta name="description" content="<150자 개인 설명>">
<!-- Google Fonts -->
<link rel="preconnect" href="https://fonts.googleapis.com">
<link href="https://fonts.googleapis.com/css2?family=<HeadingFont>:wght@400;600;700&family=<BodyFont>:wght@400;500&display=swap" rel="stylesheet">
<!-- OG Tags -->
<meta property="og:title" content="<Name> — <Role>">
<meta property="og:description" content="<description>">
<meta property="og:image" content="<og-image.jpg>">
<meta name="twitter:card" content="summary_large_image">
<link rel="stylesheet" href="styles.css">
</head>
<body>
<nav class="nav" id="nav">...</nav>
<main>
<section class="hero" id="home">...</section>
<section class="work" id="work">...</section>
<section class="about" id="about">...</section>
<section class="skills" id="skills">...</section> <!-- 선택 사항 -->
<section class="contact" id="contact">...</section>
</main>
<footer class="footer">...</footer>
<div class="project-modal" id="modal" aria-hidden="true">...</div> <!-- 선택 사항 라이트박스 -->
<script src="main.js"></script>
</body>
</html>
3.2 CSS 아키텍처
/* ── 1. Google Fonts ── */
/* ── 2. CSS Variables ── */
:root {
/* Colors from Design Brief */
--color-bg: <hex>;
--color-bg-secondary: <hex>;
--color-text: <hex>;
--color-text-muted: <hex>;
--color-accent: <hex>;
--color-border: <hex>;
/* Typography */
--font-heading: '<HeadingFont>', serif;
--font-body: '<BodyFont>', sans-serif;
/* Type scale */
--text-hero: clamp(3rem, 8vw, 7rem);
--text-h2: clamp(1.75rem, 4vw, 2.75rem);
--text-h3: clamp(1.125rem, 2vw, 1.5rem);
--text-body: 1.0625rem;
--text-sm: 0.875rem;
/* Spacing */
--section-padding: clamp(5rem, 12vw, 10rem);
--container-width: 1200px;
--gap: 1.5rem;
--radius: 8px;
--radius-lg: 16px;
/* Transitions */
--transition: 0.3s ease;
--transition-slow: 0.6s ease;
}
/* ── 3. Reset + Base ── */
/* ── 4. Layout (.container, .section, .grid-2, .grid-3) ── */
/* ── 5. Nav (fixed, scroll-aware bg change) ── */
/* ── 6. Hero ── */
/* ── 7. Work / Project Grid ── */
/* ── 8. Project Card + Hover ── */
/* ── 9. About ── */
/* ── 10. Skills ── */
/* ── 11. Contact ── */
/* ── 12. Footer ── */
/* ── 13. Modal / Lightbox (if used) ── */
/* ── 14. Scroll animations ── */
/* ── 15. Responsive ── */
3.3 프로젝트 그리드
<!-- 선택적 필터가 있는 작업 섹션 -->
<section class="work" id="work">
<div class="container">
<div class="work__header">
<h2 class="work__title">Selected Work</h2>
<!-- 선택적 필터 탭 -->
<div class="work__filters" role="tablist">
<button class="filter-btn active" data-filter="all">All</button>
<button class="filter-btn" data-filter="design">Design</button>
<button class="filter-btn" data-filter="dev">Development</button>
</div>
</div>
<div class="work__grid" id="work-grid">
<!-- Project Card -->
<article class="project-card" data-category="design" data-index="0">
<div class="project-card__image">
<img src="assets/images/project-1.jpg" alt="<Project Name> — <간단한 설명>" loading="lazy">
<div class="project-card__overlay">
<span class="project-card__type"><Type></span>
<h3 class="project-card__title"><Project Name></h3>
<div class="project-card__tags">
<span class="tag">Design</span>
<span class="tag">Branding</span>
</div>
</div>
</div>
</article>
<!-- <article class="project-card" ...> → x5 (최대 6개) -->
</div>
</div>
</section>
3.4 카드 호버 효과
/* 개성 있는 호버 — 단순한 불투명도 변경이 아님 */
.project-card {
position: relative;
overflow: hidden;
cursor: pointer;
transition: transform var(--transition), box-shadow var(--transition);
}
.project-card:hover {
transform: translateY(-4px);
box-shadow: 0 20px 40px rgba(0, 0, 0, 0.15);
}
.project-card__overlay {
position: absolute;
inset: 0;
background: linear-gradient(
to top,
rgba(0, 0, 0, 0.8) 0%,
rgba(0, 0, 0, 0.2) 50%,
transparent 100%
);
opacity: 0;
transition: opacity var(--transition);
display: flex;
flex-direction: column;
justify-content: flex-end;
padding: 1.5rem;
color: white;
}
.project-card:hover .project-card__overlay {
opacity: 1;
}
3.5 필터 기능
// main.js — 프로젝트 필터
const filterButtons = document.querySelectorAll('.filter-btn');
const projectCards = document.querySelectorAll('.project-card');
filterButtons.forEach(btn => {
btn.addEventListener('click', () => {
const filter = btn.dataset.filter;
// 활성 버튼 업데이트
filterButtons.forEach(b => b.classList.remove('active'));
btn.classList.add('active');
// 카드 필터링
projectCards.forEach(card => {
if (filter === 'all' || card.dataset.category === filter) {
card.style.display = '';
} else {
card.style.display = 'none';
}
});
});
});
3.6 배포 준비
# 1. Vercel CLI 확인
which vercel || npm i -g vercel
# 2. Deploy
cd portfolio
vercel
# 3. (선택 사항) Vercel 대시보드에서 커스텀 도메인 설정
# 4. (선택 사항) GitHub 저장소에 푸시하여 Vercel 자동 배포 연결
Phase 4 — 전달
사전 배포 점검 목록
- 모든 이미지가 최적화되었습니까? (압축, 올바른 크기,
loading="lazy") -
alt텍스트가 설명적이고 정확합니까? - OG 이미지가 설정되었고 올바르게 보입니까?
- 모든 외부 링크가 새 탭에서 열리나요? (
target="_blank" rel="noopener noreferrer") - 연락처 섹션의
mailto:링크가 작동하나요? - 모바일 보기가 모든 화면 크기에서 좋아 보이나요?
- 스크롤 애니메이션이 과하지 않습니까? (멀미 유발 금지)
- 성능 테스트를 통과했습니까? (Vercel 분석, Lighthouse)
- (선택 사항) 방문자가 올바른 미리보기를 보는지 확인하기 위해 소셜 링크를 공유해 보셨습니까?
사용자 승인 기준
- 히어로에 개성이 있음 — 누군가 빠르게 이해함? 예 / 아니오
- 포트폴리오 유형이 명확함 — "아, [역할]이군요"? 예 / 아니오
- 작업물이 작업을 대표함 — "이 사람과 함께 일하고 싶다"? 예 / 아니오
- 시각적으로 독특함 — 웹에서 본 다른 포트폴리오와 다름? 예 / 아니오
- 배포가 성공적임 — Vercel URL이 작동하고, 모든 링크가 살아 있음? 예 / 아니오
[생략된 섹션: Phase 4 (계속) 및 Phase 5 — 전체 내용은 SKILL.md의 전체 버전을 참조하세요]
