Communitygithub.com

MikeCheng1208/BattleTree

네오-브루탈리즘과 스위스 디자인 원칙에 기반한, 타이포그래피 중심의 미니멀 포트폴리오 디자인 시스템입니다. 개발자/디자이너 포트폴리오를 위해 굵은 타이포그래피, 넉넉한 여백, 무채색 구성, 우아한 단순함을 강조합니다.

BattleTree란 무엇인가요?

이 스킬은 개발자와 디자이너를 위해 미니멀하고 타이포그래피에 집중한 포트폴리오 웹사이트를 만드는 방법을 안내합니다. 네오-브루탈리즘(Neo-Brutalism)과 스위스 디자인(Swiss Design) 원칙을 결합하여 가독성, 시각적 계층 구조, 전문성을 최우선으로 합니다. 이 스킬은 주로 HTML, CSS, JavaScript로 구축된 정적 포트폴리오 사이트에 적합하며, Tailwind CSS나 Vanilla CSS와 같은 프레임워크와도 호환됩니다. 디자인 철학의 핵심은 '타이포그래피를 주인공'으로 삼고, 8pt 그리드 기반의 여백 시스템, 무채색 팔레트(검정, 흰색, 회색), 그리고 엄격한 타이포그래피 계층 구조를 통해 콘텐츠에 집중하게 합니다. 이 시스템은 불필요한 장식, 과도한 애니메이션, 여러 색상을 배제하고, 굵은 대체 텍스트와 명확한 레이아웃으로 전문적인 인상을 주며, 기존의 화려한 포트폴리오와 차별화됩니다. SKILL.md 문서는 색상, 타이포그래피, 레이아웃, 컴포넌트 디자인 패턴 등 모든 세부 사항을 CSS 변수와 실제 코드 예제와 함께 제공하여, 개발자가 즉시 사용하거나 자신의 스타일에 맞게 조정할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MikeCheng1208/BattleTree/tree/HEAD/.agents/skills/minimalist-portfolio-design

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

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

문서

미니멀 포트폴리오 디자인 스킬

이 스킬은 미니멀한 미학을 바탕으로 깔끔하고 타이포그래피에 집중한 포트폴리오 웹사이트를 만드는 방법을 안내합니다. 네오-브루탈리즘과 스위스 디자인 원칙을 기반으로 하며, 장식적인 요소보다 가독성, 시각적 계층 구조, 전문적인 프레젠테이션을 우선시합니다.

핵심 디자인 철학

디자인 원칙:

  • 타이포그래피를 주인공으로: 글자가 시각적 무게를 담당하게 합니다.
  • 급진적 단순함: 필수적이지 않은 모든 것을 제거합니다.
  • 넉넉한 여백: 공간은 비어있는 것이 아니라 디자인 요소입니다.
  • 무채색 팔레트: 검정, 흰색, 그리고 회색 음영만 사용합니다.
  • 그리드 기반 정밀성: 모든 요소가 보이지 않는 그리드에 정렬됩니다.
  • 장식 없음: 형태는 기능을 따릅니다.
  • 스위스 디자인 영향: 깔끔하고 비대칭적인 레이아웃과 명확한 계층 구조.

이 스타일의 특징:

  • 대담하고, 자신감 있으며, 전문적
  • 깔끔하고 산만하지 않음
  • 타이포그래피 중심
  • 시대를 초월하고 우아함
  • 스캔하고 탐색하기 쉬움

이 스타일이 아닌 것:

  • 화려하거나 장난기 없음 (밝은 색상 없음)
  • 과도하게 애니메이션 처리되지 않음 (미묘한 상호작용만)
  • 어수선하거나 복잡하지 않음
  • 장식적이거나 화려하지 않음
  • 유행에 민감하거나 번지르르하지 않음

타이포그래피 시스템

폰트 선택

기본 서체 옵션 (네오-그로테스크/기하학적 산세리프):

  1. Aeonik (참고 자료에 표시된 대로) - 네오-그로테스크, 기하학적, 현대적
  2. Inter - 다재다능하며, 뛰어난 화면 가독성, 무료
  3. Satoshi - 기하학적, 깔끔함, 현대적인 느낌
  4. Supreme - 대담하고 기하학적이며 큰 디스플레이 텍스트에 적합
  5. Space Grotesk - 개성이 있는 현대적인 기하학체
  6. Neue Montreal - 스위스 스타일에서 영감을 받은 깔끔한 선
  7. General Sans - 균형 잡히고 전문적이며 다재다능함

시스템 폰트 스택 (대비책):

font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen', 'Ubuntu', 'Cantarell', sans-serif;

서체 크기 및 계층 구조

디스플레이/히어로 텍스트 ("Hello"와 같은 큰 인사말):

  • 데스크톱: 8rem-12rem (128px-192px)
  • 태블릿: 6rem-8rem (96px-128px)
  • 모바일: 4rem-6rem (64px-96px)
  • 굵기: 400-500 (레귤러에서 미디엄)
  • 줄 높이: 0.9-1.0 (좁게)
  • 자간: -0.02em ~ -0.04em (좁게)

섹션 헤더 ("색상", "타이포그래피" 등):

  • 데스크톱: 4rem-6rem (64px-96px)
  • 태블릿: 3rem-4rem (48px-64px)
  • 모바일: 2.5rem-3rem (40px-48px)
  • 굵기: 400-500
  • 줄 높이: 1.1
  • 자간: -0.02em

소제목/레이블 ("기본", "보조" 등):

  • 크기: 1.25rem-1.5rem (20px-24px)
  • 굵기: 400-500
  • 줄 높이: 1.4
  • 자간: 0

본문 텍스트 ("색상" 아래 설명과 같은):

  • 크기: 1rem-1.125rem (16px-18px)
  • 굵기: 400
  • 줄 높이: 1.6-1.7
  • 자간: 0
  • 최대 너비: 65ch (문자) - 가독성 향상

작은 텍스트/레이블 ("아래로 스크롤 ↓" 등):

  • 크기: 0.875rem-1rem (14px-16px)
  • 굵기: 400
  • 줄 높이: 1.5
  • 자간: 0.01em

탐색 링크:

  • 크기: 1rem-1.125rem (16px-18px)
  • 굵기: 400-500
  • 자간: 0

타이포그래피 규칙

  • 하나의 폰트 패밀리만 전체 사이트에 사용 (다양성보다 일관성)
  • 폰트 굵기를 사용하여 계층 구조를 만들고, 여러 폰트는 사용하지 않음
  • 큰 디스플레이 텍스트에는 좁은 자간 사용
  • 본문 텍스트에는 표준 자간 사용
  • 읽기 쉬운 본문 텍스트를 위해 넉넉한 줄 높이 (1.6-1.7)
  • 디스플레이 텍스트에는 좁은 줄 높이 (0.9-1.1)
  • 왼쪽 정렬 텍스트 (특정 히어로 요소를 제외하고 중앙 정렬 사용 금지)
  • 본문 텍스트에는 대문자 사용 금지 (작은 레이블에만 필요한 경우 사용)

색상 시스템

무채색 팔레트 (기본 접근법)

이것이 핵심 미학입니다 - 오직 검정, 흰색, 회색만 사용합니다.

색상 팔레트:

--color-black: #222222;        /* 기본 - 순수한 검정이 아닌 진한 검정 */
--color-gray-dark: #7B7B7B;    /* 보조 - 중간 회색 */
--color-gray-light: #F8F8F8;   /* 3차 - 오프화이트 배경 */
--color-white: #FFFFFF;        /* 순수한 흰색 */
--color-gray-50: #FAFAFA;      /* 가장 밝은 회색 */
--color-gray-100: #F5F5F5;     /* 매우 밝은 회색 */
--color-gray-200: #EEEEEE;     /* 밝은 회색 */
--color-gray-300: #E0E0E0;     /* 테두리 회색 */
--color-gray-400: #BDBDBD;     /* 비활성화 상태 */
--color-gray-500: #9E9E9E;     /* 중간 회색 */
--color-gray-600: #757575;     /* 텍스트 회색 */
--color-gray-700: #616161;     /* 어두운 텍스트 회색 */
--color-gray-800: #424242;     /* 거의 검정 */
--color-gray-900: #212121;     /* 가장 어두운 회색 */

색상 사용법:

  • 배경: #F8F8F8 또는 #FFFFFF (라이트 모드) / #0A0A0A (다크 모드)
  • 기본 텍스트: #222222 (라이트 모드) / #F8F8F8 (다크 모드)
  • 보조 텍스트: #7B7B7B (두 모드 모두)
  • 테두리: #E0E0E0 (라이트 모드) / #2A2A2A (다크 모드)
  • 카드/표면: #FFFFFF (라이트 모드) / #1A1A1A (다크 모드)
  • 호버 상태: 약간 어둡게/밝게 (10-15% 불투명도 변화)

강조 색상 옵션 (최소한으로 사용)

정말 필요한 경우에만 - 하나의 강조 색상을 아껴서 사용:

  • CTA에만 사용 ("북 A 콜" 버튼)
  • 주요 요소의 호버 상태에 사용
  • 활성 링크 표시기에 사용
  • 배경이나 넓은 영역에는 절대 사용하지 않음

추천 강조 색상 (하나를 선택):

  • 테크 블루: #0066FF (IBM 블루, 전문적)
  • 성공 그린: #00B386 (미묘하고 신뢰감)
  • 따뜻한 레드: #FF3B30 (애플 레드, 시선 집중)
  • 검정 유지: 강조 색상을 전혀 사용하지 않음 (가장 순수한 접근법)

색상 적용 규칙

  1. 라이트 모드 기본: 흰색/오프화이트 배경 (#F8F8F8 ~ #FFFFFF)
  2. 다크 모드 옵션: 어두운 회색/검정 배경 (#0A0A0A ~ #121212)
  3. 텍스트 대비: 본문 텍스트는 최소 4.5:1 비율, 큰 텍스트는 3:1
  4. 그라데이션 없음: 단색만 사용
  5. 그림자 없음 (또는 매우 미묘한 1-2px 그림자): 테두리를 대신 사용
  6. 호버 상태: 불투명도 변경 (0.7-0.8) 또는 배경색 변화
  7. 사진: 흑백 또는 채도 감소 (참조 자료의 인물 사진처럼)

다크 모드 고려 사항

다크 모드를 구현하는 경우:

  • 배경: #0A0A0A ~ #121212 (순수한 검정은 사용하지 않음)
  • 표면: #1A1A1A ~ #222222
  • 텍스트: #F8F8F8 ~ #FFFFFF
  • 테두리: #2A2A2A ~ #333333
  • 동일한 무채색 접근법 유지
  • 순수한 흰색을 순수한 검정 위에 사용하지 않음 (눈의 피로 유발)

레이아웃 및 간격 시스템

그리드 시스템

컨테이너 너비:

  • 최대 콘텐츠 너비: 1440px-1600px
  • 콘텐츠 패딩: 양쪽 5-10% (반응형)
  • 모바일 패딩: 양쪽 24px-32px

그리드 구조:

  • 유연성을 위한 12열 그리드
  • 히어로: 비대칭 60/40 또는 50/50 분할 (텍스트/이미지)
  • 넉넉한 거터: 열 사이 32px-48px

간격 척도 (8pt 그리드)

모든 간격은 8의 배수:

4px (0.25rem)   - 최소 간격
8px (0.5rem)    - 좁은 간격
16px (1rem)     - 작은 간격
24px (1.5rem)   - 중간 간격
32px (2rem)     - 표준 간격
48px (3rem)     - 큰 간격
64px (4rem)     - XL 간격
96px (6rem)     - 섹션 간격 (모바일)
128px (8rem)    - 섹션 간격 (태블릿)
160px (10rem)   - 섹션 간격 (데스크톱)
192px (12rem)   - 히어로 간격

수직 리듬

섹션 사이:

  • 모바일: 96px-128px
  • 태블릿: 128px-160px
  • 데스크톱: 160px-192px

섹션 내부:

  • 제목과 콘텐츠 사이: 32px-48px
  • 문단 사이: 24px-32px
  • 목록 항목 사이: 16px-24px

컴포넌트 간격:

  • 탐색 패딩: 수직 24px-32px
  • 카드 패딩: 내부 32px-48px
  • 버튼 패딩: 수평 16px-32px, 수직 12px-16px

반응형 중단점

/* 모바일 우선 접근법 */
mobile: 320px-640px
tablet: 641px-1024px
desktop: 1025px-1440px
xl: 1441px+

/* Tailwind 동등값 */
sm: 640px
md: 768px
lg: 1024px
xl: 1280px
2xl: 1536px

포트폴리오 레이아웃 패턴

히어로 섹션 (전체 뷰포트)

레이아웃: 50/50 분할 (왼쪽 텍스트, 오른쪽 이미지)
높이: 100vh (전체 뷰포트)
수직 정렬: 중앙

왼쪽:
- 큰 인사말 텍스트: "Hello"
- 부제목: "— 저는 [이름]입니다, [직책]"
- 통계 (선택 사항): "+200 프로젝트 완료"
- 스크롤 표시기: "아래로 스크롤 ↓"
- 세로 텍스트 (선택 사항): "제품 디자이너"

오른쪽:
- 큰 인물 사진
- 흑백 또는 채도 감소
- 전문적이고 자신감 있는 포즈
- 배경 없음 (또는 미묘한 그라데이션)

탐색:

  • 위치: 절대 상단 또는 고정 상단
  • 높이: 80px-100px
  • 로고: 왼쪽 상단 (가장자리에서 24px-32px)
  • 링크: 상단 중앙 또는 오른쪽
  • CTA: 오른쪽 상단 ("북 A 콜" + 화살표)
  • 배경: 스크롤 시 투명 또는 미묘한 backdrop-blur
  • 테두리: 없음 또는 아래쪽 1px 테두리 (#E0E0E0)

소개/정보 섹션

레이아웃: 단일 열, 가운데 정렬 콘텐츠
최대 너비: 800px-900px (가독성)
제목: 왼쪽 정렬, 크게
본문: 왼쪽 정렬, 편안한 줄 길이

포트폴리오 그리드

데스크톱: 3열
태블릿: 2열
모바일: 1열
간격: 32px-48px
카드 종횡비: 4:3 또는 16:9

여백 철학

공간이 많을수록 = 더 고급스러움

  • 빈 공간은 디자인 요소입니다
  • 모든 픽셀을 채우지 마세요
  • 콘텐츠가 숨 쉴 수 있게 하세요
  • 여백을 사용하여 시선을 유도하세요
  • 균형이 중요합니다: 너무 듬성듬성하지도, 너무 빽빽하지도 않게

여백 체크리스트:

  • 모든 요소 주변에 여유 공간이 있습니까?
  • 눈이 섹션을 쉽게 식별할 수 있습니까?
  • 레이아웃이 차분하고 정돈되어 보입니까?
  • 관련 항목은 더 적은 공간으로 그룹화되었습니까?
  • 관련 없는 항목은 더 많은 공간으로 분리되었습니까?

컴포넌트 디자인 패턴

탐색 모음

구조:

[로고]                    [자기소개] [포트폴리오] [서비스] [블로그]                    [북 A 콜 →]

사양:

  • 높이: 80px-100px
  • 위치: backdrop-filter 블러가 있는 고정 상단 또는 절대 위치
  • 배경: 스크롤 시 투명 → 반투명
  • 로고: 간단한 워드마크 또는 아이콘 (24px-32px 크기)
  • 링크: 16px-18px, 미디엄 굵기
  • 링크 간격: 32px-48px 간격
  • CTA 버튼: 외곽선 또는 채우기, 오른쪽 정렬
  • 호버: 불투명도 0.7 또는 미묘한 밑줄 (1-2px)

모바일 탐색:

  • 햄버거 메뉴: 간단한 3줄 아이콘 (24px)
  • 메뉴: 전체 화면 오버레이 또는 슬라이드인 드로어
  • 링크: 더 큰 텍스트 (24px-32px), 세로 스택
  • 애니메이션: 부드러운 200-300ms 이즈

버튼

기본 버튼 (CTA):

padding: 수직 14px-16px, 수평 28px-32px
border-radius: 4px-8px (미묘하게, 알약 모양은 사용하지 않음)
font-size: 16px-18px
font-weight: 500
background: #222222 (또는 강조 색상)
color: #FFFFFF
border: none 또는 1-2px solid
hover: opacity: 0.9 또는 transform: translateY(-2px)

보조 버튼:

기본 버튼과 동일한 크기
background: transparent
color: #222222
border: 1-2px solid #222222
hover: background: #222222, color: #FFFFFF

텍스트 링크:

배경 없음, 테두리 없음
밑줄: 1px solid (호버 시에만) 또는 항상 표시
호버: opacity: 0.7

카드 (프로젝트 카드)

구조:

┌──────────────────────────┐
│                          │
│      프로젝트 이미지      │
│       (16:9 비율)        │
│                          │
├──────────────────────────┤
│  프로젝트 제목            │
│  간단한 설명...           │
│  [태그] [태그] [태그]      │
└──────────────────────────┘

사양:

  • 배경: #FFFFFF 또는 #FAFAFA
  • 테두리: 1px solid #E0E0E0 또는 미묘한 그림자
  • 테두리 반경: 8px-12px (미묘하게)
  • 패딩: 0 (이미지는 가장자리까지) + 아래쪽 24px-32px
  • 이미지: 전체 너비 채움, 고정 종횡비
  • 호버: 1.02 배율 또는 그림자로 들어올리기 또는 테두리 색상 변경
  • 전환: 200-300ms 이즈

카드 콘텐츠:

  • 제목: 20px-24px, 미디엄 굵기
  • 설명: 16px, 레귤러, 최대 2-3줄
  • 태그: 12px-14px, 패딩 6px-12px, rounded-full, 테두리 1px

통계 표시 ("+200 프로젝트 완료")

스타일:

숫자: 3rem-4rem (48px-64px), 미디엄 굵기
라벨: 1rem (16px), 레귤러 굵기, 회색
레이아웃: 세로 스택
간격: 숫자와 라벨 사이 8px

위치:

  • 히어로 텍스트 근처
  • 미묘하게, 주요 메시지와 경쟁하지 않음
  • 여러 통계를 나란히 배치 가능 (32px-48px 간격)

사진/이미지

인물 사진 (히어로):

  • 흑백 또는 심하게 채도 감소
  • 전문적이고, 직접 응시
  • 깔끔한 배경 (단색 또는 미묘한 그라데이션)
  • 고품질: 선명하고, 조명이 잘 잡힘
  • 종횡비: 세로 (3:4) 또는 정사각형 (1:1)
  • 크기: 크게, 뷰포트의 40-50%를 채움

프로젝트 이미지:

  • 고품질: 목업 또는 스크린샷
  • 모든 프로젝트에서 일관된 종횡비
  • 고려 사항: 16:9 (가로) 또는 4:3
  • 호버: 약간 확대 (scale 1.05) 또는 효과 없음
  • 대체 텍스트: 접근성을 위해 항상 포함

아이콘

아이콘 스타일:

  • 미니멀: 선 아이콘만 사용 (채워진 아이콘 사용 금지)
  • 선 두께: 1.5px-2px
  • 크기: 표준 20px-24px, 주요 32px-40px
  • 색상: 텍스트 색상과 일치 (#222222 또는 #7B7B7B)
  • 예시: 화살표 (→), 메뉴 (≡), 닫기 (×), 소셜 아이콘

아이콘 사용법:

  • 탐색: 햄버거 메뉴, CTA 화살표
  • 소셜 링크: GitHub, LinkedIn, Twitter/X, Email
  • 화살표: 링크, 버튼, 스크롤 표시기 용도
  • 최소한으로 유지: 아이콘을 과도하게 사용하지 않음

양식 (문의 양식)

입력 필드:

padding: 16px
border: 1px solid #E0E0E0
border-radius: 4px-8px
background: #FFFFFF 또는 #FAFAFA
font-size: 16px
focus: border-color: #222222, outline: none

레이블:

font-size: 14px-16px
font-weight: 500
margin-bottom: 8px
color: #222222

레이아웃:

  • 단일 열, 전체 너비
  • 필드: 이름, 이메일, 메시지 (최대 3개 필드)
  • 간격: 필드 사이 24px
  • 제출 버튼: 전체 너비 또는 오른쪽 정렬

스크롤 표시기

텍스트 스타일:

"아래로 스크롤 ↓"
font-size: 14px-16px
color: #7B7B7B
위치: 하단 중앙 또는 하단 왼쪽
애니메이션: 미묘한 바운스 (선택 사항)

대안:

  • 애니메이션 선/화살표
  • 휠 애니메이션이 있는 마우스 아이콘
  • 미묘하고 미니멀하게 유지

포트폴리오 페이지 구조

1. 히어로 섹션 (접히는 부분 위)

목적: 즉각적인 인상, 명확한 정체성

콘텐츠:

  • 큰 인사말: "Hello" (또는 변형)
  • 이름과 직책: "— 저는 [이름]입니다, [직책]"
  • 선택적 통계: "+200 프로젝트 완료" "+50 스타트업 자금 조달"
  • 스크롤 표시기: "아래로 스크롤 ↓"
  • 인물 사진: 오른쪽, 흑백, 전문적

레이아웃:

  • 전체 뷰포트 높이 (100vh)
  • 50/50 분할 (왼쪽 텍스트, 오른쪽 사진) 또는 60/40
  • 수직 가운데 정렬된 콘텐츠
  • 흰색 또는 오프화이트 배경
  • 상단의 미니멀 탐색

타이포그래피:

  • "Hello": 데스크톱 10rem-12rem, 모바일 6rem
  • 부제목: 1.25rem-1.5rem, 회색 (#7B7B7B)

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

MikeCheng1208/BattleTree

Index-based file discovery using ABOUTME headers. Use INSTEAD of grep or Explore agent when searching for files by purpose or feature. Faster and more accurate than scanning code. Invoke this skill when user asks "which files handle X", "where is Y implemented", or when you need to find files related to a feature or task.

MikeCheng1208/BattleTree

Factor modeling and portfolio construction (Markowitz, Black-Litterman, constraints, turnover).

MikeCheng1208/BattleTree

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

MikeCheng1208/BattleTree

Analyze the CustomGPT.ai Labs Innovation workbook and cost tracking data to surface portfolio-level insights, trends, and recommendations for where to focus Innovation efforts.

MikeCheng1208/BattleTree

Personal meta-skill for Arach. Use this as the entry point to understand arach's projects, conventions, and available skills. Activates on "arach's projects", "what does arach work on", or when working in any arach/* repo.

MikeCheng1208/BattleTree

High-converting landing pages. Copy + design + implementation. Triggers: landing page, conversion page.

MikeCheng1208/BattleTree

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios,...

MikeCheng1208/BattleTree

Automate Klipfolio tasks via Rube MCP (Composio). Always search tools first for current schemas.

MikeCheng1208/BattleTree

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

MikeCheng1208/BattleTree

Optimize project portfolio selection under constraints using mathematical optimization

MikeCheng1208/BattleTree

Detect and explain risk drift in lending portfolios over time using vintage analysis, migration matrices, and concentration metrics. Use when monitoring portfolio credit quality trends, preparing board risk reports, conducting stress testing, or when risk metrics deviate from appetite thresholds.

MikeCheng1208/BattleTree

Build a GitHub portfolio that gets you hired — curate 3-5 polished projects, craft compelling READMEs, deploy live demos, tell a coherent story across your repos, and align everything to AI-native development roles. Use when preparing your GitHub for job searches, deciding what to pin, or auditing your public presence.

관련 스킬