Communitygithub.com

portfolio-maker

엔지니어, 디자이너, 에디터, 연구자 또는 컨설턴트를 위한 프로덕션 수준의 개인 포트폴리오를 React 앱 또는 단일 HTML 파일로 구축합니다.

portfolio-maker란 무엇인가요?

이 스킬은 개발자, 디자이너, 연구원 등 다양한 전문가를 위해 완전히 자율적으로 프로덕션 등급의 개인 포트폴리오를 생성합니다. 외부 디자인 스킬이나 서드파티 라이브러리에 의존하지 않고, 타입그래피 계산, 공간 조화, 마이크로 인터랙션 등 모든 미적 판단을 스킬 자체에 내장하여 'AI 슬롭(AI Slop)'을 철저히 배제합니다. 생성된 포트폴리오는 반드시 통과해야 하는 엄격한 심미적 필터(금지된 보라색 네온 그라데이션, 평범한 회색 박스 그리드 등)가 적용되며, 대신 티타늄 모노크롬, 프리시전 에메랄드, 인터내셔널 코발트 등 엘리트 컬러 팔레트를 사용합니다. React + Vite + TypeScript 전체 코드베이스(권장) 또는 단일 HTML 파일 형태로 즉시 배포 가능한 결과물을 제공하며, 사용자와의 대화형 인터뷰를 통해 직무, 프로젝트 메트릭, 시각적 스타일을 정확히 반영합니다. 이 스킬은 무료 오픈소스 shadcn MCP 서버와 21st.dev 마스터 카탈로그(11,750개 이상의 컴포넌트)를 직접 활용하여 고품질의 생산 가능한 코드를 생성하도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/NaitikGrover/portfolio-maker/tree/HEAD

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

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

문서

Portfolio Maker: 독립적 디자인 & 엔지니어링 스킬

독립적 & 자급자족: 이 스킬은 완전한 자율성으로 작동합니다. 외부의 제3자 디자인 또는 애니메이션 스킬에 의존하거나 위임하거나 요구하지 않습니다. 모든 미적 직관, 타입그래피 계산, 공간 조화, 마이크로 인터랙션 동역학, 안티 슬롭(Anti-Slop) 적용, 컴포넌트 프리미티브는 이 스킬에 네이티브로 내장되어 있습니다.


🎯 주요 목적 및 사명

아마추어적이고 평범한 'AI 슬롭' 포트폴리오를 없애고, 5가지 핵심 아키타입의 모든 전문가를 위한 수상 경력에 빛나는 프로덕션급 포트폴리오를 자율적으로 제작합니다.

  1. 소프트웨어 엔지니어 및 시스템 아키텍트 (분산 시스템, 고처리량 API, 깔끔한 기술 벤토)
  2. 비디오 에디터, 모션 그래픽 및 크리에이터 (바이럴 쇼릴, 비교/대비 색보정 예시, 조회수 지표)
  3. 프로덕트 디자이너 및 UI/UX 리드 (디자인 시스템, 케이스 스터디, 고대비 스위스 타입그래피, 토큰 분석)
  4. AI/ML 연구원 및 데이터 엔지니어 (모델 아키텍처, arXiv 논문, 벤치마크 텔레메트리, 가중치 배지)
  5. 에이전시, 컨설턴트 및 솔로프러너 (사회적 증명, 고객 리뷰, 서비스 등급, 매끄러운 예약 전환)

🚫 반(反) AI 슬롭 명예 규약 (엄격 적용)

생성되는 모든 포트폴리오는 코드를 출력하기 전에 이 엄격한 미적 필터를 반드시 통과해야 합니다.

1. 금지된 비주얼 슬롭:

  • ❌ 절대 보라색/바이올렛 네온 그라데이션 클리셰 사용 금지: from-purple-500 via-indigo-500 to-pink-500 헤드라인 텍스트 금지. 흐릿한 보라색 배경 빛 구체(bg-purple-500/10 blur-3xl) 금지.
  • ❌ 평평하고 지루한 회색 박스 그리드 금지: 깊이나 질감이 전혀 없는 기본 Tailwind bg-gray-100 / border-gray-300 블록 사용 금지.
  • ❌ 과포화 레이저 테두리 금지: 강렬한 신스웨이브 네온 스트로크 사용 금지.

2. 승인된 엘리트 컬러 팔레트:

  • 티타늄 모노크롬 (스위스 다크/라이트): 진한 흑요석 캔버스(#09090b), 돌출된 카드 레이어(#121215 + backdrop-blur-md), 헤어라인 테두리(border-white/[0.08]), 선명한 흰색 헤딩(#ffffff), 징크 흐릿한 텍스트(#a1a1aa), 미묘한 슬레이트/흰색 스포트라이트(rgba(255,255,255,0.06)).
  • 프리시전 에메랄드 & 슬레이트: 흑요석 캔버스(#09090b), 에메랄드 라이브 상태 표시기(#10b981), 모노크롬 카드에 미묘한 민트 호버 악센트.
  • 인터내셔널 일렉트릭 코발트: 진한 차콜 캔버스(#0a0a0f), 선명한 흰색 타입그래피, 고대비 일렉트릭 로열 블루(#2563eb) 상호작용 대상 및 버튼.
  • 웜 건축 샌드 & 에스프레소: 따뜻한 크림 캔버스(#fafaf9), 풍부한 에스프레소 헤딩(#18181b), 미묘한 샴페인/앰버(#d97706) 악센트.
  • 시네마틱 로즈 & 앰버: 흑요석 #0b0c10 캔버스, 고임팩트 로즈(#e11d48)와 따뜻한 앰버(#f59e0b) 악센트 (크리에이티브 및 비디오 쇼릴용).

3. 금지된 AI 플러프(Fluff) 카피:

  • ❌ 금지: "아이디어를 우아한 디지털 솔루션으로 변환하는 열정적인 개발자."
  • ❌ 금지: "디자인, 기술, 공감의 교차점에서 혁신을 주도합니다."
  • ❌ 금지: "문제 해결 능력을 갖춘 결과 지향적인 전문가."
  • ✅ 필수: 구체적이고, 메트릭 기반이며, 영향력에 초점을 맞춘 진술:
    • "14ms p99 지연 시간으로 120k req/s를 처리하는 분산 Go 마이크로서비스 구축."
    • "7500만 이상의 유기적 조회수를 생성한 바이럴 장편 YouTube 다큐멘터리 편집."
    • "42개 엔지니어링 스쿼드에 걸쳐 채택된 멀티 브랜드 Figma 디자인 토큰 시스템 주도."

🧠 네이티브 미적 엔진 (내장된 디자인 인텔리전스)

AI는 모든 요소에 다음 수학적 디자인 법칙을 적용해야 합니다.

1. 타입그래피 계층 & 광학 리듬

  • 디스플레이 헤드라인 (text-4xl ~ text-6xl md:text-7xl) :
    • 줄 간격은 빡빡해야 함 (leading-[1.08] ~ leading-[1.12]). 큰 글꼴에 느슨한 행간은 아마추어처럼 보임.
    • 자간은 좁혀야 함 (tracking-tight 또는 tracking-tighter).
    • 글꼴 두께: 기술 분야는 Bold 또는 Extrabold (font-bold / font-extrabold); 에디토리얼 세리프는 Medium 또는 Semibold (font-medium / font-semibold).
  • 본문 (text-base ~ text-lg) :
    • 줄 간격은 넉넉해야 함 (leading-relaxed 또는 leading-7) (가독성 보장).
    • 줄 길이(Measure): max-w-xl 또는 max-w-2xl을 사용하여 본문 너비 제한 (줄당 45~75자). 문단을 전체 화면 너비로 늘리지 마세요.
    • 텍스트 정렬: 본문 텍스트 3줄 이상을 연속으로 중앙 정렬하지 마세요. 인간의 독서 인체 공학을 위해 왼쪽 정렬.
  • 큐레이티드 폰트 페어링:
    • 모던 테크: Inter 또는 Geist Sans + 태그 및 코드용 JetBrains Mono.
    • 고임팩트 크리에이티브: Plus Jakarta Sans 또는 Syne + Inter.
    • 에디토리얼 & 럭셔리: Cormorant Garamond (세리프 디스플레이) + Inter (산세 본문).

2. 공간 리듬 & 8포인트 수학 그리드

  • 섹션 패딩: 넉넉한 수직 여백 (py-20 md:py-28). 좁은 섹션은 디자인을 질식시킴.
  • 레이아웃 스택: 주요 섹션 간의 수직 간격은 space-y-24 또는 space-y-28를 사용.
  • 카드 그리드: gap-6 또는 gap-8로 표준화.
  • 콘텐츠 너비 컨테이너:
    • 에디토리얼 / 미니멀리스트: max-w-4xl mx-auto px-6
    • 개발자 벤토: max-w-5xl mx-auto px-4 sm:px-6
    • 미디어 쇼릴: max-w-6xl mx-auto px-4 sm:px-6

3. 표면 높이 & 헤어라인 테두리 과학

  • 레이어 0 (캔버스): #09090b (다크) / #fafaf9 또는 #ffffff (라이트).
  • 레이어 1 (카드 베이스): #121215 / bg-white dark:bg-zinc-900/60 + backdrop-blur-md.
  • 레이어 2 (헤어라인 테두리): border border-zinc-200/80 dark:border-zinc-800/80 또는 border border-white/[0.08]. 무겁고 지저분한 드롭 섀도우는 절대 사용 금지.
  • 레이어 3 (마이크로 호버): 커서를 따라가는 방사형 스포트라이트 (rgba(255,255,255,0.06)), 또는 미묘한 테두리 밝기 증가 hover:border-zinc-400 dark:hover:border-zinc-700, 미묘한 들림 효과 hover:-translate-y-0.5 transition-all duration-300.

4. 인터랙티브 디테일 & 마감 처리

  • 라이브 상태 표시기:
    <div class="inline-flex items-center gap-2 px-3 py-1.5 rounded-full text-xs font-medium bg-emerald-500/10 text-emerald-600 dark:text-emerald-400 border border-emerald-500/20">
      <span class="w-2 h-2 rounded-full bg-emerald-500 animate-pulse"></span>
      <span>2026년 1분기 기회에 열려 있습니다</span>
    </div>
    
  • 원클릭 이메일 복사 필 (시각적 피드백 포함): "복사됨!"을 확인하는 툴팁 전환과 함께 즉시 클립보드 복사 제공.
  • 듀얼 모드 테마 전환기: 아이콘 모핑과 localStorage 지속성을 갖춘 작동하는 테마 토글(다크/라이트)을 항상 포함.

📦 검증된 컴포넌트 무기고 (직접 접근)

이 스킬에는 검증된 프로덕션 준비 TSX 프리미티브와 전체 카탈로그가 포함되어 있습니다.

1. 시그니처 히어로 (components-library/heroes/):

  • ImageStreamHero.tsx : 깊이감 있는 소실점 스트리밍 레일 (크리에이터 및 비디오 에디터)
  • PerspectiveTunnelHero.tsx : 라이브 메트릭이 있는 3D Z축 공간 원근 (엔지니어 및 아키텍트)
  • ProductRailGallery.tsx : 스윙 물리학이 있는 인터랙티브 의류 랙 (전자상거래 및 패션)
  • TiltedGridHero.tsx : 시청자 쪽으로 휘어지는 곡선 3D 이미지 스트림 (UI/UX 디자이너 및 사진작가)
  • PrismHero.tsx : 크로매틱 크리스털 굴절 셰이더 미학 (아트 디렉터 및 럭셔리 포트폴리오)
  • TigerTearRevealHero.tsx : 인터랙티브 티어 리빌 슬로건 효과 (고임팩트 크리에이티브)
  • AgencyHero01.tsx : 소셜 아바타 및 평점 배지가 있는 높은 신뢰도의 에이전시 히어로 (프리랜서 및 에이전시)
  • ResponsiveHeroBanner.tsx : 유리 형태(Glassmorphic) 내비게이션이 있는 시네마틱 배너 (창업자 및 리더)
  • CenteredImageFanHero.tsx : 3-이미지 부채꼴 콜라주가 포함된 하이라이트 헤드라인 (프로덕트 디자이너)

2. 독립형 인터랙티브 프리미티브 (components-library/):

  • 배경: backgrounds/AuroraBackground.tsx (미묘한 에메랄드/시안/슬레이트 웨이브, 네온 퍼플 없음)
  • 인터랙티브 카드: cards/SpotlightCard.tsx (마우스 추적 광선), cards/Card3D.tsx (원근 기울기), cards/BorderBeam.tsx (애니메이션 헤어라인 테두리 빔), cards/Meteors.tsx (유성 입자)
  • 섹션 & 레이아웃: sections/BentoGrid.tsx (비대칭 반응형 그리드), sections/InfiniteMarquee.tsx (끊김 없는 기술/로고 티커), sections/BeforeAfterSlider.tsx (인터랙티브 이미지/비디오 비교), sections/VideoModal.tsx (시네마틱 비디오 팝업), sections/TerminalWidget.tsx (시뮬레이션된 인터랙티브 CLI)
  • UI 컨트롤: ui/FloatingNav.tsx (떠 있는 유리 형태 필 내비게이션 바), ui/ShimmerButton.tsx (반짝이는 액션 버튼), ui/TextGenerateEffect.tsx (엇갈린 단어 드러내기), ui/CopyEmailButton.tsx (원클릭 복사 필), ui/ThemeToggle.tsx (다크/라이트 테마 전환)

3. 마스터 컴포넌트 인덱스:

  • 21st.dev 마스터 카탈로그 전체는 components-library/catalog/INDEX.md에서 확인 가능하며, 22개 카테고리(버튼, 히어로, 갤러리, 기능, 가격, 푸터, FAQ 등)에 걸쳐 11,750개 이상의 분류된 컴포넌트를 포함합니다.

4. 공식 shadcn MCP 서버 (API 키 불필요):

  • AI는 공식 shadcn MCP 서버 (npx shadcn@latest mcp)를 사용하며, 이는 100% 무료 오픈소스이며 API 키가 전혀 필요하지 않습니다.
  • 카탈로그의 모든 컴포넌트는 다음을 통해 설치할 수 있습니다:
    npx shadcn@latest add "https://21st.dev/r/<author>/<component-name>"
    
  • 유료 21st.dev MCP 또는 API 키가 필요하지 않습니다.

5. 프리미엄 템플릿 및 모션 디자인 영감:

AI는 세계에서 가장 프리미엄인 디자인 생태계의 아키텍처 패턴, 운동 역학, 높은 전환율의 레이아웃을 적극적으로 활용할 수 있습니다:

  • VibeUI (vibeui.dev): 현대적인 컴포넌트 구성, 촉각적 카드 스택, 인터랙티브 배지, 떠 있는 제어 필 및 미적 레이아웃 프리미티브.
  • Trical (trical.so): 매우 깔끔하고 전환율이 높은 포트폴리오 템플릿, 매거진급 타입그래피, 미묘한 구분선, 에디토리얼 프로젝트 케이스 스터디.
  • Motion Site (motion.site.ai): 유동적인 마이크로 애니메이션, 운동학적 헤드라인 드러내기, 스프링 물리학, 유기적 전환 곡선.
  • 21st.dev & Aceternity UI: 11,750개 이상의 shadcn 호환 컴포넌트 및 공간 3D 상호작용 프리미티브의 마스터 카탈로그.

⚡ 이중 전달 모드

AI는 사용자의 필요에 따라 두 가지 유연한 전달 형식을 지원합니다.

모드 A: 전체 React + Vite + Tailwind (TypeScript) 코드베이스 (기본값)

완전하고 모듈식이며 엔터프라이즈급 프로젝트 구조를 생성합니다:

my-portfolio/
├── package.json
├── vite.config.ts
├── tailwind.config.js
├── postcss.config.js
├── tsconfig.json
├── index.html
└── src/
    ├── main.tsx
    ├── App.tsx
    ├── index.css
    ├── components/
    │   ├── ui/ (Spotlight, ThemeToggle, CopyEmailButton, FloatingNav)
    │   └── sections/ (Hero, BentoGrid, Projects, Experience, Footer)
    └── types/index.ts

모드 B: 즉시 사용 가능한 단일 파일 HTML/Tailwind/Lucide/JS

사용자가 별도 설정 없이 즉시 로컬 브라우저에서 미리 보거나 (예: GitHub Pages) 즉시 호스팅하기를 원할 때:

  • 아름답게 포맷된 단일 자체 포함 index.html을 생성합니다.
  • Tailwind CSS CDN, Google Fonts, Lucide Icons CDN, 테마 전환, 복사 피드백, 모달 팝업 및 호버 상호작용을 위한 바닐라 JS를 포함합니다.
  • 프로덕션 참조 구현은 templates/developer-bento/index.html, templates/creative-minimalist/index.html, templates/video-editor-showreel/index.html에서 확인할 수 있습니다.

🛠️ 단계별 실행 워크플로우

┌────────────────────────────────────────────────────────┐
│  1단계: 정보 수집 및 이력서 추출                       │
│  지표, 역할, 프로젝트, 기술 스택 추출                    │
│  (또는 3배치 대체 설문지 실행)                         │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  2단계: 필수 대화형 정렬                               │
│  질문: 미적 스타일, 테마 모드, 히어로 및 컴포넌트 선택  │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  3단계: 컴포넌트 선택 및 아키텍처                      │
│  components-library/에서 21st.dev 프리미티브 조합       │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  4단계: 프로덕션 코드 생성                              │
│  React + Vite (기본값) 또는 독립형 HTML 생성             │
└───────────────────────────┬────────────────────────────┘
                            │
┌───────────────────────────▼────────────────────────────┐
│  5단계: 감사 및 실행 지침                               │
│  안티 슬롭 규칙 확인, 빌드 검증, 명령어 제공            │
└────────────────────────────────────────────────────────┘

1단계: 정보 수집 프로토콜

  1. 사용자가 이력서 또는 LinkedIn 요약을 제공하는 경우: 실제 지표, 경력 타임라인, 상위 3~4개 프로젝트 및 기술 역량을 파싱합니다.
  2. 이력서가 제공되지 않은 경우: 절대 자격을 허위로 만들어서는 안 됩니다. references/questionnaire.md에서 3배치 설문지를 실행합니다:
    • 배치 1: 정체성 및 목표 역할
    • 배치 2: 상위 2~3개 프로젝트 및 구체적인 수치
    • 배치 3: 소셜 및 연락처 링크

2단계: 필수 대화형 정렬 (건너뛰지 마세요)

사용자가 시각적 스타일과 컴포넌트를 미리 지정하지 않는 한, 일시 중지하고 대화형 정렬을 제시합니다:

*"포트폴리오를 생성하기 전에 시각적 디자인과 인터랙티브 컴포넌트를 맞춤 설정해 보겠습니다:

  1. 시각적 스타일 / 미학:
    • 슬릭 테크 / 다크 벤토 (Linear / 21st.dev 스타일 — 흑요석 캔버스, 스포트라이트 호버 카드, 헤어라인 테두리).
    • 클린 미니멀리스트 / 스위스 모던 (Dieter Rams / Apple 스타일 — 넉넉한 여백, 정제된 타입그래피, 미묘한 선).
    • 고대비 에디토리얼 (세리프 헤드라인, 스튜디오 미학, 매거진 스타일 케이스 스터디).
    • 시네마틱 크리에이터 / 모션 (깊고 어두운 캔버스, 풍부한 비디오 쇼릴 임베드, 조회수 배지).
    • 네오-브루탈리즘

[번역이 잘렸습니다]

관련 스킬