Communitygithub.com

MikeCheng1208/BattleTree

AI 개발자 역할에 맞춰 GitHub 포트폴리오를 구축하고 다듬습니다. 구직 준비, 핀 고정 결정, 공개 프로필 감사 시 사용하세요.

BattleTree란 무엇인가요?

이 스킬은 GitHub 포트폴리오를 단순한 코드 저장소에서 채용 담당자를 사로잡는 큐레이션된 전시관으로 변환합니다. 양보다 질에 초점을 맞춰, 3~5개의 정제된 프로젝트만 골라 모든 핀 고정된 저장소가 채용 담당자의 한 가지 질문에 명확히 답하도록 구성합니다. 각 프로젝트에 설득력 있는 README 작성, 라이브 데모 배포, 프로젝트 간 일관된 스토리 구축, AI 네이티브 개발 역할에 맞춘 정렬 방법을 다룹니다. Claude Code, Cursor, Codex 등 모든 AI 에이전트 플랫폼에서 사용할 수 있으며, 제공된 SKILL.md 문서를 기반으로 포트폴리오 감사, README 구조화, 스토리 아크 구성, 배포 전략 수립을 위한 구체적이고 실행 가능한 지침을 제공합니다.

지원 대상✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/MikeCheng1208/BattleTree/tree/HEAD/.agents/skills/portfolio-strategy

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

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

문서

포트폴리오 전략

핵심 원칙

여러분의 GitHub는 미완성 프로젝트의 묘지가 아닙니다. 큐레이션된 전시관입니다. 핀 고정된 모든 저장소는 채용 담당자가 여러분에 대해 가질 한 가지 질문에 답해야 하며, 모든 답변은 그들이 면접을 잡고 싶게 만들어야 합니다.

인상적인 것과 평범한 것을 가르는 기준

평범한 포트폴리오                    인상적인 포트폴리오
─────────────────                   ────────────────────
저장소 30개, 대부분 포크             저장소 5개, 모두 독창적 작업
README 없음                           각 README가 이야기를 들려줌
라이브 데모 없음                      모든 프로젝트가 배포됨
무작위 튜토리얼 클론                 명확한 테마와 발전
마지막 커밋: 8개월 전                일관되고 최근의 활동
저장소에 설명 없음                    모든 저장소에 한 줄 설명
"my-first-react-app"                  "AI 기반 코드 리뷰 도구"

차이는 재능이 아닙니다. 큐레이션입니다. 최고의 포트폴리오는 만지는 모든 것을 커밋하는 사람이 아니라, 계획을 가진 사람처럼 보입니다.


양보다 질

3~5개의 정제된 프로젝트가 30개의 버려진 저장소보다 낫습니다. 항상 그렇습니다.

중요한 계산

저장소README배포됨채용 담당자의 생각
3020"시작은 하지만 끝맺음은 못 함"
1551"이것저것 해봄. 무엇을 잘하는지 불명확"
554"집중력 있음. 배포함. 전문성 있음"
333"만지는 모든 것이 정제됨"

정리 규칙

새로운 것을 추가하기 전에, 이미 있는 것을 감사하세요:

1. 미완성이고 복구 불가능한 것은 보관 처리하거나 비공개로 전환합니다.
2. 수정하지 않은 포크 저장소는 삭제합니다.
3. 공개로 유지할 모든 것에 README를 추가합니다.
4. 모든 공개 저장소에 설명을 설정합니다.
5. 남은 것은 보여줄 가치가 있어야 합니다.

이력서에 넣지 않을 것이라면, 공개 GitHub에 있어서도 안 됩니다.


저장소 전체에 스토리 담기

핀 고정된 저장소는 무작위 샘플이 아닙니다. 챕터입니다. 방문자가 내러티브를 볼 수 있도록 배열하세요.

효과적인 스토리 구조

전문가 아크:

"AI/ML에 깊이 파고들며, 증명할 수 있습니다."

저장소 1: 특정 도메인 작업을 위한 미세 조정 LLM
저장소 2: 평가 프레임워크를 포함한 RAG 파이프라인
저장소 3: 도구 사용을 포함한 에이전트 워크플로
저장소 4: LangChain/LlamaIndex에 대한 오픈소스 기여

풀스택 빌더 아크:

"데이터베이스부터 배포까지 완전한 제품을 구축합니다."

저장소 1: 풀스택 SaaS 앱 (Next.js + API + DB + Auth)
저장소 2: AI 기반 CLI 도구 (백엔드/시스템 능력 증명)
저장소 3: 오픈소스 라이브러리 (API 설계 사고 증명)
저장소 4: 개인 자동화 도구 (자신을 위해 구축함을 증명)

AI 네이티브 개발자 아크:

"AI를 사용할 뿐만 아니라 AI로 구축하고 AI를 위해 구축합니다."

저장소 1: 에이전트 워크플로 / 멀티 에이전트 시스템
저장소 2: 프로덕션 등급 앱의 LLM 통합
저장소 3: AI를 활용하는 개발자 도구 (린터, 리뷰어, 생성기)
저장소 4: AI 프레임워크 또는 툴체인에 기여

발전 신호

채용 담당자는 저장소가 성장을 보여줄 때 알아차립니다:

신호의미
초기 저장소: 단순 CRUD 앱어딘가에서 시작했음
중간 저장소: 테스트와 CI가 있는 API엔지니어링 관행을 배웠음
최근 저장소: 평가가 포함된 AI 에이전트최전선에서 구축 중임
주요 OSS 프로젝트에 기여대규모 코드베이스에서 작업 가능함

무엇을 핀 고정할 것인가와 그 이유

핀 고정 가능한 저장소는 6개입니다. 전략적으로 사용하세요.

이상적인 핀 레이아웃

슬롯핀 고정할 항목이유
1풀스택 프로젝트완전한 제품 구축 능력 증명
2AI/ML 프로젝트최전선 작업 증명
3오픈소스 기여실제 코드베이스 협업 증명
4개발자 도구 또는 CLI자신의 문제 해결 능력 증명
5도메인 프로젝트 (전문 분야)목표 역할에 대한 깊이 신호
6와일드카드 — 개인적이거나 창의적인 것성격과 진정한 호기심 표현

핀 고정 규칙

핀 고정해야 할 것:
  - 라이브 데모 또는 배포 링크가 있는 프로젝트
  - 철저한 README와 스크린샷이 있는 저장소
  - 지원하는 역할과 일치하는 작업
  - 가장 최근의, 가장 정제된 작업

핀 고정하지 말아야 할 것:
  - 의미 있게 수정하지 않은 포크 저장소
  - 튜토리얼 따라하기 (완료했더라도)
  - README가 없는 저장소
  - 면접에서 설명할 수 없는 모든 것

포트폴리오 피치로서의 README

모든 핀 고정된 저장소에는 30초 안에 프로젝트를 판매하는 README가 필요합니다. 채용 담당자는 계속 읽을지 결정하기 전에 그보다 더 적은 시간을 씁니다.

포트폴리오 저장소용 README 구조

# 프로젝트 이름
무엇을 하는지와 왜 중요한지에 대한 한 문장 설명.

## 데모
[라이브 데모 링크] | [동영상 워크스루 링크]

앱 동작을 보여주는 스크린샷 또는 GIF.

## 문제
이것이 해결하는 문제는 무엇인가요? 누가 이 문제를 가지고 있나요?

## 작동 방식
아키텍처 개요. 주요 기술적 결정.
시스템에 여러 구성 요소가 있는 경우 다이어그램.

## 기술 스택
기술 목록 — 그러나 의미 있는 것만 나열하세요.
HTML/CSS는 나열하지 마세요. AI 통합, 데이터베이스, 배포 대상을 나열하세요.

## 주요 기능
- 기능 1 — 기술적으로 흥미로운 이유
- 기능 2 — 구축 시 어려웠던 점
- 기능 3 — 다음에 개선할 점

## 시작하기
명확한 설정 지침. 누군가 5분 안에 실행할 수 있어야 합니다.

## 배운 점
가장 어려웠던 기술적 과제와 해결 방법에 대한 간단한 회고.

README 안티 패턴

나쁜 README더 나은 README
"React 앱""회의록을 작업 항목으로 바꾸는 AI 기반 회의 요약기"
스크린샷 없음첫 화면 위에 히어로 스크린샷 또는 GIF
설정: "클론하고 실행"설정: 사전 조건과 함께 단계별 안내
아키텍처 설명 없음구성 요소 연결 방식을 보여주는 시스템 다이어그램
모든 npm 패키지 나열중요한 3-4가지 기술만 강조

라이브 데모 및 배포 링크

코드는 가설입니다. 배포된 앱은 증명입니다.

배포가 중요한 이유

채용 담당자가 데모 없는 저장소를 봄:
  "흥미로운 코드네... 실제로 작동하나?"

채용 담당자가 라이브 링크가 있는 저장소를 봄:
  "한번 써보자." → 2분 후 → "이 사람은 배포하는구나."

프로젝트 유형별 배포 옵션

프로젝트 유형무료 배포적합한 대상
풀스택 웹 앱Vercel, Railway, Fly.io프로덕션 느낌 앱
API / 백엔드Railway, Render백엔드 기술 과시
정적 사이트 / 문서GitHub Pages, Netlify문서, 랜딩 페이지
AI/ML 데모Hugging Face Spaces, Streamlit Cloud모델 데모, 데이터 앱
CLI 도구npm publish, Homebrew tap배포 신호

배포할 수 없으면, 데모를 녹화하세요

모든 것을 클라우드에서 실행할 수 있는 것은 아닙니다. 로컬 전용 도구, CLI 앱 또는 복잡한 시스템의 경우:

1. 60-90초 분량의 동영상 워크스루를 녹화하세요.
2. YouTube에 업로드하세요 (미등록 상태도 괜찮습니다).
3. 주요 상호작용의 GIF를 만드세요.
4. 둘 다 README에 넣으세요.

동영상 데모는 데모가 없는 것보다 10배 낫습니다.


기여 그래프

일관성이 주는 신호

채용 담당자는 기여 그래프를 훑어봅니다. 그들이 실제로 읽는 내용은 다음과 같습니다:

패턴해석
대부분의 날에 꾸준한 초록색"이 사람은 정기적으로 코딩합니다. 좋은 습관입니다."
프로젝트 주변에 군집"집중된 스프린트로 작업합니다. 정상입니다."
주중에만 초록색"직장이 있으면서도 개인 작업을 배포합니다."
자신의 저장소와 기여 혼합"협력적입니다. 혼자 하는 프로젝트만 있는 게 아닙니다."

조작의 징후

경험 많은 평가자는 이것들을 즉시 알아챕니다:

위험 신호:
  - 완벽하게 균일한 초록색 (매일 같은 강도)
  - README 편집이나 공백 변경만 있는 커밋
  - 하루에 빈 저장소에 500개의 커밋
  - 한 주에 생성된 수십 개의 저장소, 모두 단일 커밋
  - 자동 생성된 커밋 봇

그래프를 조작하는 것은 공백보다 더 나쁩니다. 절박함과 나쁜 판단력을 신호합니다. 진정한 일관성은 관심 있는 일을 정기적인 주기로 작업하는 것을 의미합니다 — 공백이 있더라도 말이죠.

실제 그래프 만들기

가짜를 만드는 대신:
  1. 하나의 프로젝트를 골라 매일 30분씩 작업하세요.
  2. 오픈소스에 기여하세요 — 문서, 테스트, 버그 리포트도 포함됩니다.
  3. 노트와 실험을 커밋하는 학습 저장소를 유지하세요.
  4. 실제로 사용하는 도구를 만드세요. 자연스럽게 계속 개선하게 됩니다.

원하는 역할에 포트폴리오 맞추기

포트폴리오는 채용되었을 때 할 작업의 미리보기처럼 보여야 합니다. 목표에 맞게 조정하세요.

AI 네이티브 개발 역할

이러한 역할은 AI로 구축하고 AI를 위해 구축할 수 있음을 보여주길 원합니다:

신호예시 저장소
워크플로에서 AI 도구 사용.claude/ 설정, AI 지원 커밋, Claude Code 슬래시 명령어가 있는 프로젝트
에이전트 워크플로연구, 계획, 실행하는 다단계 에이전트
LLM 통합구조화된 출력, 프롬프트 엔지니어링, 모델 라우팅이 있는 앱
RAG 및 검색임베딩 검색 및 평가 메트릭이 있는 지식 베이스
평가 및 테스트LLM 출력 평가 프레임워크, 프롬프트 회귀 테스트
AI 지원 개발AI 도구가 개발을 가속화한 방법을 문서화한 프로젝트 README

역할별 포트폴리오 목표

목표 역할필수 저장소있으면 좋은 것
AI/ML 엔지니어미세 조정 모델, 평가 프레임워크, 데이터 파이프라인논문 구현, 모델 비교
풀스택 AI 개발자LLM 통합 앱, RAG 시스템, 배포된 SaaS오픈소스 기여, CLI 도구
플랫폼/인프라 엔지니어CI/CD 파이프라인, IaC 저장소, 모니터링 설정성능 벤치마크, OSS 기여
개발자 도구/DXCLI 도구, SDK/라이브러리, VS Code 확장문서 사이트, 개발자 커뮤니티 도구

포트폴리오 리뷰 체크리스트

매 구직 전에 이 감사를 실행하세요. 솔직해지세요.

첫인상 (30초)

  • 프로필 사진이 전문적입니다 (또는 의도적으로 독특합니다)
  • 약력이 자신이 무엇을 하는지와 무엇을 찾고 있는지 명시합니다
  • 핀 고정된 저장소에 낯선 사람이 이해할 수 있는 설명이 있습니다
  • 최소 3개의 핀 고정된 저장소 README에 스크린샷 또는 데모 링크가 있습니다
  • 첫 페이지에 보이는 창피한 저장소 이름이 없습니다

깊이 확인 (2분)

  • 각 핀 고정된 저장소에 무엇을, 왜, 어떻게 설명하는 README가 있습니다
  • 최소 한 프로젝트에 라이브 데모 또는 배포 링크가 있습니다
  • 핀 고정된 저장소의 코드 품질이 현재 기술 수준을 반영합니다
  • 커밋 기록이 실제 개발을 보여줍니다 (단일 "initial commit" 덩어리가 아님)
  • 최소 한 저장소가 테스트 또는 CI/CD를 보여줍니다

스토리 확인 (5분)

  • 핀 고정된 저장소가 기술에 대한 일관된 이야기를 들려줍니다
  • 이전 프로젝트에서 최신 프로젝트로의 가시적인 발전이 있습니다
  • 포트폴리오가 목표로 하는 역할과 일치합니다
  • 모든 핀 고정된 저장소를 60초 엘리베이터 피치로 설명할 수 있습니다
  • 이 GitHub를 보고 자신을 채용할 의향이 있습니다

궁극의 테스트

시크릿 창에서 GitHub를 열어보세요. 자신을 한 번도 만난 적 없는 채용 담당자라고 가정하세요. 60초를 투자하세요. 이 후보자를 다음 라운드로 보내시겠습니까?

대답이 즉각적인 '예'가 아니라면, 계속 반복하세요.


안티 패턴

안티 패턴해로운 이유수정 방법
변경 없는 포크 저장소부풀리기처럼 보임삭제 또는 비공개 전환
튜토리얼 클론 ("todo-app", "weather-app")구축할 수 있다는 신호가 아닌, 지시를 따랐다는 신호포크한 후, 튜토리얼을 훨씬 넘어 확장
빈 저장소 또는 README만 있는 저장소버려진 아이디어 신호보관 또는 삭제
공개 저장소에 README 없음"내 작업에 대해 소통하지 않음"공개로 유지하는 모든 것에 README 추가
큐레이션 없이 50개 이상의 공개 저장소압도적인 소음, 신호 없음적극적으로 보관, 전략적으로 핀 고정
오래된 핀 고정 저장소 (2년 이상)"최근에 구축한 것이 없음"최신 작업을 보여주도록 핀 교체
자동 생성된 통계만 있는 프로필 README비인격적, 노력 부족집중 분야와 목표를 담은 실제 약력 작성
"test", "temp", "asdf" 같은 저장소 이름부주의이름 변경 또는 제거

파워 무브

"제 GitHub 포트폴리오를 [여러분의 GitHub URL]에서 검토해 주세요. AI 네이티브 개발 역할의 채용 담당자처럼 평가해 주세요. 각 핀 고정된 저장소를 README 품질, 기술적 깊이, 배포 상태, AI/ML 역할 관련성에 대해 점수 매겨 주세요. 그런 다음 우선순위가 정해진 실행 계획을 알려주세요: 무엇을 보관할지, 무엇을 개선할지, 무엇이 빠졌는지, 가장 큰 차이를 만들 하나의 새 프로젝트는 무엇인지."

에이전트가 포트폴리오 비평가가 되어 — GitHub를 코드 묘지에서 경력 자산으로 바꾸는 데 필요한 솔직하고 구체적인 피드백을 제공합니다.

관련 스킬

스킬사용 시기
github-profileGitHub 플랫폼 메커니즘 구현 — 프로필 README, 저장소 핀 고정, 토픽, 활동 그래프
career-resume전체 경력 주기 — 구직, 면접, 온보딩, 성과 검토

Individual skills in this repo

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

MikeCheng1208/BattleTree

Index-based file discovery using ABOUTME headers. Use INSTEAD of grep or Explore agent when searching for files by purpose or feature. Faster and more accurate than scanning code. Invoke this skill when user asks "which files handle X", "where is Y implemented", or when you need to find files related to a feature or task.

MikeCheng1208/BattleTree

Factor modeling and portfolio construction (Markowitz, Black-Litterman, constraints, turnover).

MikeCheng1208/BattleTree

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

MikeCheng1208/BattleTree

Analyze the CustomGPT.ai Labs Innovation workbook and cost tracking data to surface portfolio-level insights, trends, and recommendations for where to focus Innovation efforts.

MikeCheng1208/BattleTree

Personal meta-skill for Arach. Use this as the entry point to understand arach's projects, conventions, and available skills. Activates on "arach's projects", "what does arach work on", or when working in any arach/* repo.

MikeCheng1208/BattleTree

High-converting landing pages. Copy + design + implementation. Triggers: landing page, conversion page.

MikeCheng1208/BattleTree

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios,...

MikeCheng1208/BattleTree

Automate Klipfolio tasks via Rube MCP (Composio). Always search tools first for current schemas.

MikeCheng1208/BattleTree

Minimalist, typography-focused portfolio design system inspired by neo-brutalist and Swiss design principles. Emphasizes bold typography, generous whitespace, monochromatic color schemes, and elegant simplicity for developer/designer portfolios.

MikeCheng1208/BattleTree

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

MikeCheng1208/BattleTree

Optimize project portfolio selection under constraints using mathematical optimization

MikeCheng1208/BattleTree

Detect and explain risk drift in lending portfolios over time using vintage analysis, migration matrices, and concentration metrics. Use when monitoring portfolio credit quality trends, preparing board risk reports, conducting stress testing, or when risk metrics deviate from appetite thresholds.

관련 스킬