Communitygithub.com

bg-szy/TOP-SKILLS

실제로 취업과 고객 확보로 이어지는 포트폴리오 제작 전문 - 단순한 작업 전시가 아닌, 기억에 남는 경험을 창조합니다. 개발자, 디자이너, 크리에이티브 포트폴리오와 방문자를 기회로 전환하는 포트폴리오를 다룹니다.

TOP-SKILLS란 무엇인가요?

이 스킬은 포트폴리오가 단순한 이력서나 작품 모음집이 아니라, 첫인상을 통해 취업이나 클라이언트 확보로 이어지도록 설계하는 '포트폴리오 경험 디자이너' 역할을 수행합니다. 채용 담당자가 포트폴리오에 평균 30초만 투자한다는 점을 인지하고, 그 짧은 시간 안에 방문자가 '당신이 누구인지, 무엇을 하는지, 최고의 작업은 무엇인지, 어떻게 연락할지'를 명확히 알 수 있도록 구조화합니다. CSS, JavaScript, HTML을 포함한 다양한 기술을 활용하여 단일 페이지 스크롤, 멀티 페이지, 하이브리드 등 효과적인 포트폴리오 아키텍처를 제안하며, 개발자, 디자이너, 크리에이티브 등 대상에 맞춘 최적의 프로젝트 쇼케이스 전략과 마이크로인터랙션을 통한 참여 유도 방법을 제공합니다. 또한 포트폴리오가 실제 작업보다 복잡해지는 경우, 모바일 호환성, 명확한 CTA 부재, 구식 작업 노출 등 일반적인 함정과 해결책을 진단하고, MVP 접근법을 통해 빠르게 출시하고 반복 개선할 것을 권장합니다. 이 스킬은 `scroll-experience`, `3d-web-experience`, `landing-page-design`, `personal-branding` 스킬과 함께 사용할 때 가장 효과적입니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/bg-szy/TOP-SKILLS/tree/HEAD/skills/marketplace/interactive-portfolio

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

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

문서

인터랙티브 포트폴리오

실제로 취업과 고객 확보로 이어지는 포트폴리오 제작 전문 - 단순한 작업 전시가 아닌, 기억에 남는 경험을 창조합니다. 개발자 포트폴리오, 디자이너 포트폴리오, 크리에이티브 포트폴리오, 방문자를 기회로 전환하는 포트폴리오를 다룹니다.

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

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

전문 분야

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

역량

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

패턴

포트폴리오 아키텍처

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

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

포트폴리오 아키텍처

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 앱

기술 쇼케이스

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

블로그/글쓰기

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

포트폴리오 인터랙티비티

기억에 남는 인터랙티브 요소 추가

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

포트폴리오 인터랙티비티

인터랙티비티 수준

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

영향력 높고, 위험 낮은 요소

  • 데스크톱용 커스텀 커서
  • 부드러운 페이지 전환
  • 프로젝트 카드 호버 효과
  • 스크롤 트리거 리빌
  • 다크/라이트 모드 토글

창의적인 아이디어

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

균형

  • 창의성은 기술을 보여줌
  • 그러나 사용성이 일자리를 결정
  • 모바일에서 완벽하게 작동해야 함
  • 콘텐츠를 인터랙션 뒤에 숨기지 마세요
  • 복잡한 인트로에는 "건너뛰기" 옵션 제공

예리한 엣지

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

심각도: 중간

상황: 포트폴리오에 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만이 아닌)

우아한 저하

/* 복잡한 호버 → 간단한 탭 */
@media (hover: none) {
  .hover-effect {
    /* 콘텐츠를 직접 표시 */
  }
}

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

심각도: 중간

상황: 훌륭한 포트폴리오, 연락처 0건

증상:

  • 조회수는 많지만 연락 없음
  • 사람들이 당신이 가능한지 모름
  • 연락처 페이지가 부차적임
  • 명확한 요청이 없음

왜 문제인가: 명확한 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 20 individual skills — each has its own dedicated page.

bg-szy/TOP-SKILLS

Brand-first landing page designer — runs a brand-identity interview (colors, typography, shape language), then generates and iterates on a polished landing page via Stitch with deployment-ready HTML. Use when the user asks to create, design, or build a landing page, homepage, or marketing page and has no established visual direction. Skip when they have a design mockup, need a dashboard or app UI, are working at component level, building a multi-page app, or restyling with known design tokens — use frontend-design instead.

bg-szy/TOP-SKILLS

Fill out Microsoft Azure Landing Zone (ALZ) Accelerator checklists by interviewing the user, mapping their Azure subscriptions, integrating IP addressing documentation, and applying Microsoft Cloud Adoption Framework best practices. Produces a completed Excel checklist (.xlsx) ready for ALZ deployment. Use this skill whenever the user mentions Azure Landing Zone, ALZ checklist, landing zone accelerator, platform landing zone configuration, ALZ bootstrap, hub-and-spoke setup, Azure network topology planning, or wants to fill out any ALZ-related checklist or configuration file. Also trigger when the user uploads an Excel file that contains tabs like "Accelerator - Bootstrap", "Accelerator - Bicep", or "Accelerator - Terraform".

bg-szy/TOP-SKILLS

Compose a premium, animated landing page section by section in Next.js + Tailwind + Motion (Framer Motion) — built on a real design system, with editorial copy and motion that feels human-crafted, not template-generated. Use when building or rebuilding a landing page, marketing site, or hero/feature/pricing/CTA sections that need to look production-ready and bespoke from day one.

bg-szy/TOP-SKILLS

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

bg-szy/TOP-SKILLS

Optimize landing pages for conversions, performance, and SEO. Use when improving landing pages, increasing conversions, or optimizing page performance.

bg-szy/TOP-SKILLS

Review investment portfolios for risk, diversification, fees. Asset allocation recommendations, tax-loss harvesting, rebalancing.

bg-szy/TOP-SKILLS

Beads Viewer - Graph-aware triage engine for Beads projects. Computes PageRank, betweenness, critical path, and cycles. Use --robot-* flags for AI agents.

bg-szy/TOP-SKILLS

CI red? Call us. Pipeline fire brigade deploys. Use when user mentions CI failures, build errors, test failures, or pipeline issues. Do NOT load for: local builds, standard implementation work, reviews, or setup.

bg-szy/TOP-SKILLS

CASS Memory System - procedural memory for AI coding agents. Three-layer cognitive architecture with confidence decay, anti-pattern learning, cross-agent knowledge transfer, trauma guard safety system. Bun/TypeScript CLI.

bg-szy/TOP-SKILLS

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

bg-szy/TOP-SKILLS

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

bg-szy/TOP-SKILLS

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

bg-szy/TOP-SKILLS

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

bg-szy/TOP-SKILLS

Landing page conversion optimization with layout rules, hero section design, and CTA psychology. Covers above-the-fold formula, social proof placement, mobile design, and F-pattern reading. Use for: startup landing pages, product pages, SaaS marketing, conversion optimization. Triggers: landing page, hero section, above the fold, conversion optimization, landing page design, cta button, hero image, landing page layout, saas landing page, product page design, conversion rate, landing page best practices

bg-szy/TOP-SKILLS

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

bg-szy/TOP-SKILLS

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

bg-szy/TOP-SKILLS

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

bg-szy/TOP-SKILLS

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

관련 스킬