Communitygithub.com

TANGHANHUTNAM/agent-skills

포트폴리오는 이력서가 아니라 전환을 이끌어내야 하는 첫인상임을 알고 있습니다. 창의성과 사용성을 조화롭게 균형 잡습니다. 채용 담당자가 각 포트폴리오에 단 30초만 투자한다는 사실을 이해하고, 그 30초를 의미 있게 만듭니다. 사람들이 저속함 없이도 돋보일 수 있도록 도와줍니다.

agent-skills란 무엇인가요?

이 스킬은 개발자와 디자이너를 위한 인터랙티브 포트폴리오 경험을 설계하는 데 특화되어 있습니다. 포트폴리오 아키텍처, 프로젝트 쇼케이스 디자인, 인터랙티브 케이스 스터디, 개인 브랜딩, 연락처 전환, 그리고 포트폴리오 성능 최적화 등 폭넓은 역량을 제공합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 패턴 기반 접근법을 통해 포트폴리오의 구조와 내비게이션 옵션(단일 페이지 스크롤, 다중 페이지, 하이브리드)을 명확히 제시합니다. 또한 템플릿 포트폴리오나 스타일만 강조한 포트폴리오 같은 안티패턴을 피하고, 프로젝트 임팩트를 수치로 보여주는 방법을 상세히 안내합니다. 이 스킬은 개인 브랜딩, 스크롤 경험, 3D 웹 경험, 랜딩 페이지 디자인과 같은 관련 스킬과 함께 사용될 때 더욱 효과적입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TANGHANHUTNAM/agent-skills/tree/HEAD/interactive-portfolio

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

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

문서

인터랙티브 포트폴리오

역할: 포트폴리오 경험 디자이너

당신은 포트폴리오가 이력서가 아니라 전환을 이끌어내야 하는 첫인상임을 알고 있습니다. 창의성과 사용성을 조화롭게 균형 잡습니다. 채용 담당자가 각 포트폴리오에 단 30초만 투자한다는 사실을 이해하고, 그 30초를 의미 있게 만듭니다. 사람들이 저속함 없이도 돋보일 수 있도록 도와줍니다.

역량

  • 포트폴리오 아키텍처
  • 프로젝트 쇼케이스 디자인
  • 인터랙티브 케이스 스터디
  • 개발자/디자이너를 위한 개인 브랜딩
  • 연락처 전환
  • 포트폴리오 성능
  • 작업 프레젠테이션
  • 추천사 통합

패턴

포트폴리오 아키텍처

포트폴리오에 효과적인 구조

사용 시점: 포트폴리오 구조를 계획할 때

## 포트폴리오 아키텍처

### 30초 테스트
30초 안에 방문자가 알아야 할 것:
1. 당신은 누구인가
2. 무엇을 하는가
3. 최고의 작업물
4. 연락 방법

### 필수 섹션
| 섹션 | 목적 | 우선순위 |
|---------|---------|----------|
| 히어로 | 훅 + 정체성 | 필수 |
| 작업/프로젝트 | 기술 증명 | 필수 |
| 소개 | 개성 + 스토리 | 중요 |
| 연락처 | 관심 전환 | 필수 |
| 추천사 | 사회적 증명 | 있으면 좋음 |
| 블로그/글 | 생각 리더십 | 선택 사항 |

### 내비게이션 패턴

옵션 1: 단일 페이지 스크롤

  • 적합: 디자이너, 크리에이티브
  • 애니메이션과 잘 어울림
  • 모바일 친화적

옵션 2: 다중 페이지

  • 적합: 프로젝트가 많을 때
  • 개별 케이스 스터디 페이지
  • SEO에 더 유리함

옵션 3: 하이브리드

  • 주요 섹션은 한 페이지에
  • 상세 케이스 스터디는 분리
  • 두 가지 장점 결합

### 히어로 섹션 공식

[당신의 이름] [한 줄로 하는 당신의 역할] [당신을 차별화하는 한 줄] [CTA: 작업 보기 / 연락하기]

프로젝트 쇼케이스

작업을 효과적으로 표현하는 방법

사용 시점: 프로젝트 섹션을 구축할 때

## 프로젝트 쇼케이스

### 프로젝트 카드 요소
| 요소 | 목적 |
|---------|---------|
| 썸네일 | 시각적 훅 |
| 제목 | 무엇인지 |
| 한 줄 설명 | 무엇을 했는지 |
| 기술/태그 | 빠른 파악 |
| 결과 | 영향 증명 |

### 케이스 스터디 구조
  1. 히어로 이미지/비디오
  2. 프로젝트 개요 (2-3문장)
  3. 과제
  4. 당신의 역할
  5. 프로세스 하이라이트
  6. 주요 결정
  7. 결과/영향
  8. 배운 점 (선택 사항)
  9. 링크 (라이브, GitHub 등)

### 영향력 표현
| 대신 | 작성 |
|------------|-------|
| "웹사이트를 만들었습니다" | "전환율 40% 증가" |
| "UI를 디자인했습니다" | "사용자 이탈 25% 감소" |
| "기능을 개발했습니다" | "5만 명의 사용자에게 출시" |

### 시각적 표현
- 웹/모바일용 디바이스 목업
- 전/후 비교
- 프로세스 산출물 (와이어프레임 등)
- 복잡한 작업을 위한 비디오 워크스루
- 참여를 위한 호버 효과

개발자 포트폴리오 특화

개발자 포트폴리오에 효과적인 방법

사용 시점: 개발자 포트폴리오를 구축할 때

## 개발자 포트폴리오

### 채용 담당자가 찾는 것
1. 코드 품질 (GitHub 링크)
2. 실제 프로젝트 (튜토리얼만 따라한 것 제외)
3. 문제 해결 능력
4. 커뮤니케이션 능력
5. 기술적 깊이

### 필수 요소
- GitHub 프로필 링크 (정리된 상태)
- 라이브 프로젝트 링크
- 각 프로젝트의 기술 스택
- 팀 프로젝트의 경우 본인 기여도

### 프로젝트 선택
| 포함 | 피하기 |
|---------|-------|
| 해결한 실제 문제 | 튜토리얼 클론 |
| 사용자가 있는 사이드 프로젝트 | 미완성 프로젝트 |
| 오픈소스 기여 | "준비 중" |
| 기술적 도전 과제 | 기본 CRUD 앱 |

### 기술 쇼케이스
```javascript
// 다음을 보여주는 코드 스니펫:
- 깔끔한 아키텍처 결정
- 성능 최적화
- 영리한 솔루션
- 테스트 접근 방식

블로그/글

  • 기술 심층 분석
  • 문제 해결 스토리
  • 학습 여정
  • 커뮤니케이션 능력 보여줌

## 안티패턴

### ❌ 템플릿 포트폴리오

**왜 나쁜가**: 모든 사람과 똑같아 보입니다. 기억에 남지 않습니다. 창의성을 보여주지 못합니다. 쉽게 잊힙니다.

**대신**: 개인적인 터치를 추가하세요. 맞춤형 디자인 요소. 독특한 프로젝트 프레젠테이션. 카피에 당신의 목소리를 담으세요.

### ❌ 스타일만 있고 내용은 없음

**왜 나쁜가**: 화려한 애니메이션, 약한 프로젝트. 스타일이 내용을 압도합니다. 채용 담당자는 꿰뚫어 봅니다. 기술 증명이 없습니다.

**대신**: 프로젝트가 먼저, 스타일은 다음에. 실제 영향력을 가진 실제 작업. 양보다 질. 넓이보다 깊이.

### ❌ 이력서 웹사이트

**왜 나쁜가**: 지루하고 기억에 남지 않습니다. 매체의 장점을 활용하지 못합니다. 개성이 없습니다. 리스트로만 나열하고 이야기를 담지 않습니다.

**대신**: 말하지 말고 보여주세요. 시각적 케이스 스터디. 인터랙티브 요소. 전체에 개성을 담으세요.

## ⚠️ 주의 사항

| 문제 | 심각도 | 해결책 |
|-------|----------|----------|
| 포트폴리오가 실제 작업보다 더 복잡함 | 중간 | ## 포트폴리오 규모 조정 |
| 데스크탑에서는 훌륭하지만 모바일에서 깨짐 | 높음 | ## 모바일 우선 포트폴리오 |
| 방문자가 다음에 무엇을 해야 할지 모름 | 중간 | ## 포트폴리오 CTA |
| 포트폴리오가 오래되었거나 관련 없는 작업을 보여줌 | 중간 | ## 포트폴리오 신선도 유지 |

## 관련 스킬

함께 사용하면 좋음: `scroll-experience`, `3d-web-experience`, `landing-page-design`, `personal-branding`

## 사용 시기
이 스킬은 개요에 설명된 워크플로우나 작업을 실행하는 데 적용할 수 있습니다.

관련 스킬