Communitygithub.com

techwavedev/agi-agent-kit

당신은 포트폴리오가 이력서가 아니라 전환으로 이어져야 하는 첫인상임을 압니다. 창의성과 사용성을 균형 있게 조화시킵니다. 채용 담당자가 각 포트폴리오에 30초를 투자한다는 것을 알고 있습니다. 그 30초를 의미 있게 만듭니다. 사람들이 촌스럽지 않게 돋보일 수 있도록 돕습니다.

agi-agent-kit란 무엇인가요?

이 스킬은 포트폴리오 경험 디자이너 역할을 수행하며, 개발자와 디자이너가 30초 이내에 채용 담당자의 관심을 사로잡고 전환으로 연결되는 포트폴리오를 만들 수 있도록 안내합니다. 포트폴리오 아키텍처, 프로젝트 쇼케이스, 인터랙티브 사례 연구, 개인 브랜딩, 연락처 전환 최적화 등 다양한 역량을 제공합니다. 특히 '30초 테스트'를 기반으로 한 포트폴리오 구조, 프로젝트 카드 요소, 사례 연구 템플릿, 개발자 포트폴리오에 특화된 체크리스트를 포함한 실용적인 패턴을 제공합니다. 또한 템플릿 포트폴리오, 스타일에 치우친 구성, 이력서 웹사이트와 같은 안티 패턴을 지적하고, 군더더기 없는 맞춤형 디자인과 실제 성과 중심의 콘텐츠를 강조합니다. 이 스킬은 @techwavedev/agi-agent-kit과 함께 사용하도록 설계되어 메모리-우선 프로토콜을 통해 이전 디자인 결정을 검색하고 저장함으로써 여러 세션 간 시각적 일관성을 유지합니다. Claude, Gemini, Cursor 등 다양한 AI 플랫폼에서 에이전트 간 협업 및 디자인 토큰 지속성을 지원합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/techwavedev/agi-agent-kit/tree/HEAD/templates/skills/extended/frontend/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 프로필 링크 (정리된 상태)
- 라이브 프로젝트 링크
- 각 프로젝트의 기술 스택
- 팀 프로젝트의 경우 자신의 구체적인 기여

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

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

블로그/글쓰기

  • 기술 심층 분석
  • 문제 해결 스토리
  • 학습 여정
  • 의사소통 능력 입증

## 안티 패턴

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

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

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

### ❌ 스타일만 있고 내용은 없는 경우

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

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

### ❌ 이력서 웹사이트

**왜 나쁜가**: 지루하고, 잊혀집니다. 매체를 활용하지 못합니다. 개성이 없습니다. 스토리 대신 목록만 있습니다.

**대신**: 보여주고, 말하지 마세요. 시각적 사례 연구. 인터랙티브 요소. 전체에 개성을 담으세요.

## ⚠️ 날카로운 모서리

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

## 관련 스킬

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

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

---

<!-- AGI-INTEGRATION-START -->

## AGI 프레임워크 통합

> **[@techwavedev/agi-agent-kit](https://www.npmjs.com/package/@techwavedev/agi-agent-kit)에 맞게 조정됨**
> 원본 출처: [antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills)

### 메모리-우선 프로토콜

여러 세션 간 시각적 일관성을 유지하기 위해 이전 디자인 결정(색상 팔레트, 타이포그래피, 간격 스케일)을 검색합니다. 생성된 디자인 토큰을 캐시합니다.

```bash
# 프론트엔드/디자인 컨텍스트를 시작하기 전에 확인
python3 execution/memory_manager.py auto --query "인터랙티브 포트폴리오를 위한 디자인 시스템 결정 및 컴포넌트 패턴"

결과 저장

작업 완료 후, 향후 세션을 위해 프론트엔드/디자인 결정을 저장합니다:

python3 execution/memory_manager.py store \
  --content "디자인 시스템: 8px 그리드 채택, Inter 글꼴 패밀리 사용, 다크 모드를 지원하는 HSL 색상 토큰 사용" \
  --type decision --project <project> \
  --tags interactive-portfolio frontend

다중 에이전트 협업

백엔드 에이전트(API 계약 변경) 및 QA 에이전트(시각적 회귀 기준선)와 디자인 결정을 공유합니다.

python3 execution/cross_agent_context.py store \
  --agent "<your-agent>" \
  --action "UI 컴포넌트 구현 — WCAG 2.1 AA 접근성 준수 신규 디자인 시스템" \
  --project <project>

디자인 메모리 지속성

디자인 시스템 토큰과 컴포넌트 결정을 Qdrant에 저장하여 모든 플랫폼(Claude, Gemini, Cursor)의 모든 에이전트가 일관된 스타일링을 검색하고 적용할 수 있도록 합니다.

관련 스킬