Communitygithub.com

qike7777/skill-library

개성 넘치는 비주얼 아이덴티티로 눈에 띄는 개인 포트폴리오 웹사이트를 구축합니다. ui-ux-design-pro 디자인 데이터베이스(67개 이상의 스타일, 161개 팔레트, 57개 폰트 페어링)를 통합하여 대담하고 기억에 남는 미학을 제공합니다. 개인 브랜딩, 프로젝트 쇼케이스 레이아웃, 반응형 HTML/CSS, 인터랙티브 효과(호버/필터/라이트박스), Vercel 배포를 다룹니다. 디자이너, 개발자, 프리랜서, 창의적인 전문가를 위해 설계되었습니다.

skill-library란 무엇인가요?

이 스킬은 개인 포트폴리오 웹사이트를 체계적으로 구축하기 위한 완전한 파이프라인을 제공합니다. '이해 → 브랜드 아이덴티티 → 콘텐츠 → 구축 → 배포'의 5단계 프로세스를 통해 사용자의 정체성과 목표를 분석하고, 67개 이상의 UI 스타일, 161개의 색상 팔레트, 57개의 글꼴 페어링이 포함된 방대한 디자인 데이터베이스를 활용하여 독창적인 비주얼 아이덴티티를 만듭니다. HTML, CSS, 바닐라 JS만으로 구축되므로 프레임워크에 대한 의존성이 없고 빠르게 배포할 수 있으며, Vercel을 통해 정적 파일로 즉시 게시됩니다. 디자이너, 개발자, 크리에이티브, 프리랜서, 학생 등 다양한 포트폴리오 유형에 맞춰 히어로 카피, 프로젝트 설명, About 섹션, 스킬 표시, 연락처 등 각 콘텐츠 요소에 대한 구체적인 템플릿과 품질 기준을 제공하여 전문적이고 기억에 남는 포트폴리오를 완성하도록 돕습니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/qike7777/skill-library/tree/HEAD/skills/3-websites-and-apps/portfolio

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

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

미리보기

스킬 README에서

skill-library preview

문서

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 소개 섹션

구조:

  1. 당신은 누구인가 — 현재 상태 (역할, 위치, 집중하는 분야)
  2. 어떻게 여기까지 왔는가 — 간략한 과정 (이력서가 아닌, 이야기)
  3. 무엇에 관심을 두는가 — 작업 뒤에 있는 "이유"
  4. 무엇을 찾고 있는가 — 구직 중 / 특정 프로젝트 유형 / 협업

분량: 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의 전체 버전을 참조하세요]

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬