Communitygithub.com

Sansar35/claude-agent

채용과 고객 유치에 실제로 효과가 있는 포트폴리오를 구축하는 전문가입니다. 단순한 작업 전시가 아닌, 잊을 수 없는 경험을 만듭니다. 개발자, 디자이너, 크리에이티브 포트폴리오는 물론 방문자를 기회로 전환하는 포트폴리오를 다룹니다.

claude-agent란 무엇인가요?

이 스킬은 AI 에이전트(예: Claude Code)가 사용자를 대신하여 효과적인 포트폴리오 웹사이트를 기획, 설계, 구축하도록 안내합니다. 단순한 이력서가 아닌 30초 안에 방문자를 사로잡아 채용 또는 프로젝트 의뢰로 전환시키는 '경험'을 만드는 데 초점을 맞춥니다. 포트폴리오 아키텍처, 프로젝트 쇼케이스, 대화형 요소, 모바일 최적화, 전환 최적화 등 폭넓은 주제를 다루며, 개발자, 디자이너, 크리에이티브 등 다양한 분야에 맞춤형 조언을 제공합니다. 특히 포트폴리오가 실제 프로젝트보다 더 복잡해지거나, 모바일에서 깨지거나, 명확한 행동 유도(CTA)가 없는 등 흔히 발생하는 문제점과 그 해결책을 'Sharp Edges' 섹션에서 구체적으로 제시합니다. 이 스킬은 작업 계획 수립, 섹션 구성, 인터랙션 디자인, 성능 최적화 단계를 포괄하는 워크플로우를 제공하며, 관련 스킬(스크롤 경험, 3D 웹 경험 등)과의 협업을 통해 더 풍부한 포트폴리오를 완성할 수 있습니다.

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

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

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

문서

인터랙티브 포트폴리오

채용과 고객 유치에 실제로 효과가 있는 포트폴리오를 구축하는 전문가 - 단순히 작업을 보여주는 것이 아니라, 잊을 수 없는 경험을 만듭니다. 개발자 포트폴리오, 디자이너 포트폴리오, 크리에이티브 포트폴리오, 방문자를 기회로 전환하는 포트폴리오를 다룹니다.

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

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

전문 분야

  • 포트폴리오 UX
  • 프로젝트 프레젠테이션
  • 개인 브랜딩
  • 전환 최적화
  • 크리에이티브 코딩
  • 잊을 수 없는 경험

역량

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

패턴

포트폴리오 아키텍처

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

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

포트폴리오 아키텍처

30초 테스트

30초 안에 방문자는 다음을 알아야 합니다:

  1. 당신이 누구인지
  2. 당신이 무엇을 하는지
  3. 당신의 최고 작업
  4. 당신에게 연락하는 방법

필수 섹션

섹션목적우선순위
히어로(Hero)후크 + 정체성중요
작업/프로젝트기술 증명중요
소개(About)개성 + 스토리중요
연락처(Contact)관심 전환중요
사용후기(Testimonials)사회적 증명있으면 좋음
블로그/글사고 리더십선택 사항

네비게이션 패턴

옵션 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 앱

기술 쇼케이스

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

블로그/글

  • 기술 심층 분석
  • 문제 해결 이야기
  • 학습 여정
  • 의사소통 능력 보여주기

포트폴리오 인터랙티비티

잊을 수 없는 인터랙티브 요소 추가

사용 시기: 돋보이고 싶을 때

포트폴리오 인터랙티비티

인터랙티비티 수준

수준예시위험
미묘함호버 효과, 부드러운 스크롤낮음
중간스크롤 애니메이션, 전환중간
높음3D, 게임, 사용자 정의 커서높음

영향력 높고 위험 낮은 요소

  • 데스크톱용 사용자 정의 커서
  • 부드러운 페이지 전환
  • 프로젝트 카드 호버 효과
  • 스크롤 트리거된 나타나기 효과
  • 다크/라이트 모드 토글

창의적인 아이디어

- 터미널 스타일 인터페이스 (개발자용)
- OS 데스크톱 은유
- 게임 같은 네비게이션
- 인터랙티브 타임라인
- 3D 작업 공간 장면
- 생성형 아트 배경

균형

  • 창의성은 기술을 보여줍니다
  • 그러나 사용성이 일자리를 얻습니다
  • 모바일은 완벽하게 작동해야 합니다
  • 콘텐츠를 상호작용 뒤에 숨기지 마세요
  • 복잡한 인트로에는 "건너뛰기" 옵션이 있어야 합니다

날카로운 모서리 (Sharp Edges)

포트폴리오가 실제 작업보다 더 복잡함

심각도: 중간

상황: 포트폴리오에 6개월을 쏟았지만, 보여줄 프로젝트는 2개뿐

증상:

  • 몇 달째 "포트폴리오 작업 중"
  • 포트폴리오 자체에 프로젝트보다 더 열정적
  • 포트폴리오 기술이 작업보다 더 인상적
  • 출시가 두려움

왜 문제인가: 일을 가장한 미루기. 포트폴리오는 하나의 프로젝트이지만, 유일한 프로젝트는 아닙니다. 다듬는 데 한계 효용이 있습니다. 일단 출시하고 반복하세요.

권장 수정:

포트폴리오 적정 규모 맞추기

MVP 포트폴리오

요소MVP 버전
히어로이름 + 직함 + 한 줄
프로젝트3-4개의 최고 작품
소개2-3 문단
연락처이메일 + LinkedIn

시간 예산

1주차: 디자인 및 구조
2주차: 핵심 페이지 구축
3주차: 3-4개 프로젝트 추가
4주차: 다듬기 및 출시

진실

  • 당신의 포트폴리오는 최고의 프로젝트가 아닙니다
  • 출시하는 것이 완벽을 추구하는 것보다 낫습니다
  • 언제든지 반복할 수 있습니다
  • 더 나은 프로젝트 > 더 나은 포트폴리오

그만둬야 할 때

  • 핵심 페이지가 모바일에서 작동
  • 3-4개의 탄탄한 프로젝트가 전시됨
  • 연락처 양식이 작동
  • 3초 이내에 로딩
  • 출시하세요.

데스크톱에서는 멋지지만 모바일에서 깨짐

심각도: 높음

상황: 채용 담당자가 휴대폰으로 확인하는데 모든 것이 깨짐

증상:

  • 브라우저 DevTools에서는 멋짐
  • 실제 휴대폰에서는 깨짐
  • 텍스트가 너무 작음
  • 버튼을 누르기 어려움
  • 네비게이션이 숨겨짐

왜 문제인가: 데스크톱 우선으로 구축. 실제 기기에서 테스트하지 않음. 복잡한 상호작용이 제대로 작동하지 않음. 엄지 영역을 잊음.

권장 수정:

모바일 우선 포트폴리오

모바일 현실

  • 트래픽의 60% 이상이 모바일
  • 채용 담당자는 휴대폰으로 둘러봄
  • 첫인상 = 모바일 인상

모바일 필수 사항

  • 확대하지 않고도 읽을 수 있어야 함
  • 누를 수 있는 링크 (최소 44px)
  • 네비게이션이 작동
  • 프로젝트가 빠르게 로딩
  • 연락처를 쉽게 찾을 수 있음

테스트 체크리스트

[ ] iPhone Safari
[ ] Android Chrome
[ ] 태블릿 크기
[ ] 느린 3G 시뮬레이션
[ ] 실제 기기 (DevTools만이 아닌)

우아한 저하 (Graceful Degradation)

/* 복잡한 호버 → 간단한 탭 */
@media (hover: none) {
  .hover-effect {
    /* 내용을 직접 표시 */
  }
}

방문자가 다음에 무엇을 해야 할지 모름

심각도: 중간

상황: 훌륭한 포트폴리오지만 연락이 전혀 없음

증상:

  • 조회수는 많지만 연락 없음
  • 사람들이 당신이 일할 수 있는지 모름
  • 연락처 페이지는 부차적인 요소
  • 명확한 요청이 없음

왜 문제인가: 명확한 CTA 없음. 연락처가 바닥에 묻힘. 여러 경쟁 행동이 있음. 방문자가 스스로 알아낼 것이라고 가정.

권장 수정:

포트폴리오 CTA

주요 CTA

목표CTA
채용"함께 일합시다"
프리랜서"프로젝트 시작하기"
네트워킹"안녕하세요"
특정 역할"[X]로 저를 고용하세요"

CTA 배치

히어로 섹션: 주요 CTA
프로젝트 이후: 보조 CTA
푸터: 최종 CTA
플로팅: 선택적 고정 CTA

연락처 쉽게 만들기

  • 이메일 링크 (mailto:)
  • LinkedIn (새 탭에서 열기)
  • 캘린더 링크 (Calendly)
  • 간단한 연락처 양식
  • 이메일 복사 버튼

피해야 할 것

  • 연락처 양식만 (사람들은 양식을 싫어함)
  • 숨겨진 연락처 정보
  • 너무 많은 옵션
  • 모호한 CTA ("더 알아보기")

포트폴리오에 오래되었거나 관련 없는 작업을 보여줌

심각도: 중간

상황: 최고의 작업은 3년 전, 새로운 작업은 전시되지 않음

증상:

  • 2024년에 jQuery 프로젝트
  • 대학 시절에 한 일
  • 기술 스택이 목표 직무와 일치하지 않음
  • 2년 넘게 포트폴리오를 건드리지 않음

왜 문제인가: 몇 년 동안 업데이트하지 않음. 새로운 작업이 "준비되지 않음." 오래된 즐겨찾기를 삭제하는 것이 두려움. 포트폴리오 표류.

권장 수정:

포트폴리오 신선도

업데이트 주기

작업빈도
새 프로젝트 추가완료 시
오래된 프로젝트 제거매년 검토
카피 업데이트6개월마다
기술 리프레시1-2년마다

프로젝트 가지치기

다음과 같은 경우 유지:

  • 여전히 자랑스러움
  • 목표 직무와 관련됨
  • 중요한 기술을 보여줌
  • 좋은 결과/스토리가 있음

다음과 같은 경우 제거:

  • 코드/디자인이 부끄러움
  • 기술이 구식임
  • 목표와 관련 없음
  • 더 나은 작업이 존재함

성장 보여주기

  • 최신 작업을 먼저
  • 프로젝트에 날짜 기입 (또는 생략)
  • 관련이 있다면 진화 과정 보여주기
  • 삭제 대신 보관

유효성 검사 체크

명확한 연락처 CTA 없음

심각도: 높음

메시지: 방문자가 연락할 수 있는 명확한 방법이 없습니다.

수정 조치: 히어로 및 프로젝트 섹션 다음에 눈에 띄는 연락처 CTA 추가

모바일 뷰포트 누락

심각도: 높음

메시지: 포트폴리오가 모바일 반응형이 아닐 수 있습니다.

수정 조치: 추가

최적화되지 않은 포트폴리오 이미지

심각도: 중간

메시지: 포트폴리오 이미지가 로딩 시간을 느리게 할 수 있습니다.

수정 조치: WebP 사용, 지연 로딩 구현, 반응형 이미지를 위한 srcset 추가

프로젝트에 라이브 링크 누락

심각도: 중간

메시지: 프로젝트에는 라이브 링크나 소스 코드가 있어야 합니다.

수정 조치: 가능한 경우 라이브 데모 URL 및 GitHub 링크 추가

프로젝트에 영향/결과 누락

심각도: 낮음

메시지: 프로젝트가 영향이나 결과를 보여주지 않습니다.

수정 조치: 프로젝트 설명에 메트릭, 결과 또는 사용후기 추가

협업

위임 트리거

  • scroll animation|parallax|GSAP -> scroll-experience (포트폴리오용 스크롤 경험)
  • 3D|WebGL|three.js|spline -> 3d-web-experience (3D 포트폴리오 요소)
  • brand|logo|colors|identity -> branding (개인 브랜딩)
  • copy|writing|about me|bio -> copywriting (포트폴리오 카피)
  • SEO|search|google -> seo (포트폴리오 SEO)

개발자 포트폴리오

스킬: interactive-portfolio, frontend, scroll-experience

워크플로우:

1. 포트폴리오 구조 계획
2. 3-5개의 최고 프로젝트 선정
3. 히어로 및 프로젝트 섹션 디자인
4. 미묘한 스크롤 애니메이션 추가
5. 구현 및 최적화
6. 출시 및 공유

크리에이티브 포트폴리오

스킬: interactive-portfolio, 3d-web-experience, scroll-experience, branding

워크플로우:

1. 개인 브랜드 정의
2. 독특한 경험 디자인
3. 인터랙티브 요소 구축
4. 창의적으로 작업 전시
5. 모바일 작동 확인
6. 출시

관련 스킬

다음과 함께 잘 작동: scroll-experience, 3d-web-experience, landing-page-design, personal-branding

사용 시기

  • 사용자가 다음을 언급하거나 암시할 때: 포트폴리오
  • 사용자가 다음을 언급하거나 암시할 때: 개인 웹사이트
  • 사용자가 다음을 언급하거나 암시할 때: 작업 전시
  • 사용자가 다음을 언급하거나 암시할 때: 개발자 포트폴리오
  • 사용자가 다음을 언급하거나 암시할 때: 디자이너 포트폴리오
  • 사용자가 다음을 언급하거나 암시할 때: 크리에이티브 포트폴리오

제한 사항

  • 작업이 위에 설명된 범위와 명확하게 일치하는 경우에만 이 스킬을 사용하십시오.
  • 출력을 환경별 유효성 검사, 테스트 또는 전문가 검토의 대체물로 취급하지 마십시오.
  • 필수 입력, 권한, 안전 경계 또는 성공 기준이 누락된 경우 멈추고 명확히 요청하십시오.

Individual skills in this repo

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

관련 스킬