modu-ai/portfolio-guide
> 한국 신입 취준생·재직자를 위한 분야별 포트폴리오 구성과 프로젝트 기술서 작성 스킬입니다. "포트폴리오 만들어줘", "프로젝트 정리해줘", "노션 포트폴리오 1시간 만에"처럼 말하면 됩니다. 개발(GitHub·기술 블로그)/디자인(Figma·Behance)/마케팅/기획 분야별 + 검색되는 노션 포트폴리오 + 채용공고 맞춤형 1page 셀링 + 877건 노하우 기반 비중 배분을 지원합니다.
npx skills add https://github.com/modu-ai/cowork-plugins --skill portfolio-guide> 2026 채용 시장은 "이력서에 나열된 스펙이 아닌, 실무에서 실제로 해낼 수 있는 능력"을 봅니다. 노션 + GitHub + Behance 같은 검색되는 포트폴리오를 누적해두면 헤드헌터·원티드·리멤버에서 본인이 지원하지 않아도 오퍼가 들어오는 구조가 형성됩니다.
| 영역 | 설명 |
|------|------|
| 분야별 가이드 | 개발자, 디자이너, 마케터, 기획자 맞춤 포트폴리오 전략 |
| 프로젝트 기술서 | STAR 기반 프로젝트 설명, 기여도 정량화 |
| 플랫폼 최적화 | GitHub, Behance, Notion, 개인 블로그 포트폴리오 |
| 포트폴리오 리뷰 | 기존 포트폴리오 개선점 분석 및 피드백 |
참조 가이드: references/portfolio-by-field.md
디자인이 아니라 구조와 정량이 합격을 만든다.
[1] 한 줄 요약 (USP)
[2] 프로젝트 5개 (각 1페이지)
[3] 각 프로젝트:
- 배경 (1줄)
- 본인 역할 (1줄)
- 한 일 3~5 bullet
- 정량 결과 (숫자·배수·증감)
[4] 전체 6~10페이지 압축
메모장(.txt) 수준의 텍스트만으로도 합격 가능.
빠르게 만드는 6 섹션 구조:
[1] 한 줄 자기소개 + 사진
[2] About — 경력 한 단락
[3] Skills — 기술·도구 5~7개
[4] Projects — 3~5 카드 (썸네일 + 한 줄 + 링크)
[5] Experience — 회사·기간·역할
[6] Contact — 이메일·LinkedIn·GitHub
노션 템플릿 + 커스텀 도메인 (oopy.io, super.so) — 1시간이면 완성.
PM은 결과물이 추상적 — 구체화 방법:
| PM 산출물 | 포트폴리오 표현 |
|---|---|
| 의사결정 | Before/After 차트 + 의사결정 트리 |
| 협업 | 이해관계자 다이어그램 + 회의록 발췌 |
| 제품 변화 | 출시 전후 스크린샷 + UX 흐름 |
| 임팩트 | 매출·리텐션·CSAT 정량 |
| 학습 | 회고록 인용 (1-2 paragraph) |
마지막 페이지에 "함께 일하고 싶은 분" 한 단락 — 인성 어필.
각 프로젝트는 1페이지 (A4) 분량.
project:
title: "○○ 프로젝트"
period: "2024.03 ~ 2024.08 (6개월)"
role: "PM (5명 팀)"
background:
problem: "..."
company_context: "..."
approach:
- "..."
outcome:
- metric: "월 매출 30% 증가"
- metric: "리텐션 15% 개선"
learning: "..."
2026년 채용 시장에서 바이브 코딩(Vibe Coding)의 확산으로 기업이 요구하는 기술적 깊이가 한층 높아졌습니다. AI와 협업하며 문제를 해결하는 능력을 보여주는 것이 핵심입니다.
| 구성 요소 | 필수도 | 설명 |
|----------|:------:|------|
| GitHub 프로필 | 필수 | 커밋 히스토리, 기여 그래프, 핀 프로젝트 3-5개 |
| 기술 블로그 | 강력 권장 | 문제 해결 과정, 기술 선택 이유, 학습 기록 |
| 프로젝트 README | 필수 | 아키텍처 다이어그램, 기술 스택, 실행 방법 |
| 라이브 데모 | 권장 | Vercel/Netlify 배포 링크, 데모 영상 |
| 오픈소스 기여 | 차별화 | PR, 이슈 해결, 라이브러리 기여 기록 |
프로젝트 README 필수 항목:
## 프로젝트명
한 줄 설명
### 기술 스택
[프레임워크] [DB] [인프라] [CI/CD]
### 핵심 기능
- 기능 1: 설명 (본인 기여 부분 명시)
- 기능 2: 설명
### 아키텍처
[다이어그램 또는 설명]
### 성과/배운 점
- 응답 시간 40% 개선 (Redis 캐시 적용)
- 동시 접속 1,000명 처리 (부하 테스트 결과)
AX(AI Transformation) 시대의 디자이너는 화면을 예쁘게 만드는 것을 넘어 비즈니스 임팩트를 내는 사람이어야 합니다.
| 구성 요소 | 필수도 | 설명 |
|----------|:------:|------|
| Behance/Dribbble | 필수 | 완성도 높은 프로젝트 5-8개 |
| Figma 파일 | 강력 권장 | 컴포넌트 시스템, 프로토타입, 디자인 토큰 |
| 프로세스 문서 | 필수 | 문제 정의 → 가설 → 실험 → 검증 전체 과정 |
| AI 활용 사례 | 권장 | Midjourney, Figma AI 등 도구 활용 과정 |
| 협업 기록 | 차별화 | Jira/Confluence 협업, 개발자 소통 기록 |
케이스 스터디 구조:
1. 문제 정의: 어떤 사용자 문제를 해결했는가
2. 리서치: 사용자 인터뷰, 데이터 분석 결과
3. 가설 설정: 어떤 가설을 세웠는가
4. 디자인 과정: 와이어프레임 → 프로토타입 → 최종 디자인
5. 실험/검증: A/B 테스트, 사용성 테스트 결과
6. 비즈니스 임팩트: 전환율 변화, 이탈률 감소 등 수치
성과를 수치로 증명하는 것이 마케팅 포트폴리오의 핵심입니다.
| 구성 요소 | 필수도 | 설명 |
|----------|:------:|------|
| 캠페인 케이스 | 필수 | 목표 → 전략 → 실행 → 성과(수치) 구조 |
| 데이터 분석 | 강력 권장 | GA4, SQL, 엑셀 활용 분석 사례 |
| 콘텐츠 포트폴리오 | 권장 | SNS 게시물, 블로그, 뉴스레터 샘플 |
| 성과 대시보드 | 차별화 | Notion/Looker Studio로 정리된 KPI |
문제 발견부터 해결까지의 사고 과정을 보여주는 것이 핵심입니다.
| 구성 요소 | 필수도 | 설명 |
|----------|:------:|------|
| 기획서 샘플 | 필수 | PRD, 기능 명세서, 와이어프레임 |
| UX 리서치 | 강력 권장 | 사용자 인터뷰, 설문 분석, 퍼소나 |
| 데이터 기반 의사결정 | 권장 | A/B 테스트 결과, 지표 분석 사례 |
| 스프린트 운영 | 차별화 | 애자일 프로세스 경험, 회고 기록 |
■ 프로젝트명
한 줄 요약
■ 기간/인원/역할
YYYY.MM - YYYY.MM | N명 | 담당 역할
■ 배경 및 문제
왜 이 프로젝트를 시작했는가
■ 나의 기여 (STAR 기반)
S: 프로젝트 시작 당시 상황
T: 내가 맡은 구체적 과제
A: 실행한 행동과 의사결정
R: 정량적 성과 또는 정성적 배움
■ 기술 스택 / 도구
사용한 기술, 프레임워크, 도구 목록
■ 링크
GitHub / 배포 URL / 발표 자료
| 플랫폼 | 최적화 포인트 | 2026 가중치 (한국 채용 시장 체감) |
|--------|-------------|---|
| GitHub | 프로필 README, 핀 프로젝트, 커밋 빈도, 이슈/PR 활동, 오픈소스 기여 | 개발자 직군 필수 — 원티드·잡플래닛 IT 가중치 최상 |
| Behance/Dribbble | 커버 이미지 품질, 태그 최적화, 프로젝트 설명 영/한 병기 | 디자인 직군 필수 |
| Figma | 컴포넌트 시스템, 프로토타입, 디자인 토큰, 핸드오프 가이드 | 디자인 직군 — 협업 능력 증명 |
| Notion | 목차 구조, 토글 활용, 임베드(Figma/YouTube), 공유 설정, 검색엔진 인덱싱 허용 | 전 직군 — oopy.io·super.so로 커스텀 도메인 |
| 개인 기술 블로그 | SEO 최적화, 시리즈 구성, RSS 피드, 댓글 소통, "문제 해결 과정" 위주 | 개발·기획 — 신입 차별화 핵심 |
| 링크드인 | 헤드라인 + Featured 섹션 (포트폴리오 URL 핀) + 추천사 | 재직자 누적 — 헤드헌터 오퍼 트리거 |
| GitHub Pages·Vercel | 자체 도메인 + 라이브 데모 + 분석 도구 (GA) | 개발자 차별화 — 협업·운영 능력 증명 |
원티드·잡플래닛 IT 직군 채용 트렌드에 따르면 GitHub·노션 포트폴리오의 가중치가 학력보다 높아진 직군이 늘었습니다. 본 스킬은 분야별로 다음 차별화 요소를 자동 추천합니다.
| 분야 | 2026 차별화 요소 |
|---|---|
| 개발 | AI 도구와 협업한 문제 해결 과정 (LLM 페어 프로그래밍 회고), 실제 트래픽 운영 경험 |
| 디자인 | AX(AI Transformation) 시대의 디자인 시스템 사례, 비즈니스 임팩트 (전환율·이탈률) |
| 마케팅 | GA4·SQL 기반 데이터 분석, A/B 테스트 결과, 성과 대시보드 (Looker Studio·Notion) |
| 기획/PM | A/B 테스트 + 사용자 인터뷰 + 의사결정 트리, "왜 그 결정인가" Why-First 사고 과정 |
포트폴리오, 프로젝트, GitHub, Behance, Figma, Notion, 노션 포트폴리오, 기술서, 작품집, 1page 셀링, 검색되는 포트폴리오, 헤드헌터 노출
참조 가이드(references/)를 사용할 수 없는 경우 다음 단계로 실행합니다.
references/{id}.md 존재 시 로드 → 가이드에 따라 실행--deepthink 또는 복잡한 다분야 포트폴리오 → sequential-thinking MCP가 설치돼 있으면 mcp__sequential-thinking__sequentialthinking를 활용, 없으면 ultrathink 키워드 기반 심층 추론 또는 일반 단계 추론으로 대체프로젝트 기술서·About 단락·케이스 스터디·README 본문 등 포트폴리오의 서술 텍스트는 모두 사람이 읽는 산출물입니다. 초안 완성 후 다음 체인을 거쳐 AI 패턴을 제거하고 자연스러운 한국어로 다듬습니다.
moai-career:portfolio-guide → moai-core:ai-slop-reviewer → moai-content:humanize-korean
moai-core:ai-slop-reviewer — AI 생성 패턴(범용 표현·클리셰·형용사 남발) 1차 검수·교정moai-content:humanize-korean — 문장 리듬·구어 표현으로 2차 휴머나이즈지원 서류는 moai-career:resume-builder, JD 분석은 moai-career:job-analyzer, 면접 준비는 moai-career:interview-coach와 함께 사용하세요.
> 표·스크린샷·다이어그램·정량 대시보드 같은 비서술 산출물은 이 체인 대상이 아닙니다. 서술 텍스트 부분에만 적용합니다.
이 플러그인에서 활용할 수 있는 다른 플러그인의 에이전트:
| 에이전트 | 소속 | 용도 |
|---------|------|------|
| quality-evaluator | moai-core | 산출물 품질 PASS/FAIL 판정 |
| korean-tone-reviewer | moai-hr | 직급별 경어 사용 및 비즈니스 톤 적절성 검토 |
moai-career:resume-builder 스킬을 사용하세요.moai-career:interview-coach 스킬이 적합합니다.moai-career:job-analyzer 스킬을 사용하세요.Take modu-ai/portfolio-guide from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.