Communitygithub.com

leecyno1/boutique-skills

Alpaca MCP 서버와 연동하여 포트폴리오 보유 종목과 포지션을 가져온 후, 자산 배분, 위험 지표, 개별 주식 포지션, 분산 투자 현황을 분석하고 리밸런싱 추천을 생성하는 종합 포트폴리오 분석 도구입니다.

boutique-skills란 무엇인가요?

이 스킬은 투자 포트폴리오를 종합적으로 분석하고 관리하기 위해 설계되었습니다. Alpaca MCP 서버를 활용하여 실제 포트폴리오 데이터를 실시간으로 가져온 후, 자산 배분, 분산 투자, 위험 지표, 개별 포지션 평가, 그리고 리밸런싱 추천을 포함한 심층 분석을 수행합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 사용자가 포트폴리오 검토, 포지션 분석, 위험 평가, 성과 평가 또는 리밸런싱 제안을 요청할 때 자동으로 실행됩니다. 워크플로는 총 6단계로 구성되어 있으며, 데이터 수집, 포지션 데이터 보강, 포트폴리오 수준 분석, 개별 포지션 분석, 리밸런싱 추천, 최종 보고서 생성을 포함합니다. 분석 결과는 마크다운 형식의 종합 보고서로 출력되어 사용자에게 실행 가능한 인사이트를 제공합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/leecyno1/boutique-skills/tree/HEAD/skills/default/portfolio-manager

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

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

문서

Portfolio Manager

개요

Alpaca MCP 서버와 연동하여 실시간 포트폴리오 보유 데이터를 가져온 후, 자산 배분, 분산 투자, 위험 지표, 개별 포지션 평가 및 리밸런싱 추천을 포함한 종합 분석을 수행하고, 실행 가능한 인사이트가 담긴 상세 포트폴리오 보고서를 생성합니다.

이 스킬은 MCP(Model Context Protocol)를 통해 Alpaca의 브로커리지 API를 활용하여 실시간 포트폴리오 데이터에 접근함으로써, 수동으로 입력된 데이터가 아닌 실제 현재 포지션을 기반으로 분석을 수행합니다.

사용 시기

사용자가 다음과 같은 요청을 할 때 이 스킬을 호출하세요:

  • "내 포트폴리오 분석해 줘"
  • "내 현재 포지션 검토해 줘"
  • "내 자산 배분 상태는 어때?"
  • "포트폴리오 위험 점검해 줘"
  • "포트폴리오 리밸런싱해야 할까?"
  • "내 보유 종목 평가해 줘"
  • "포트폴리오 성과 검토"
  • "어떤 주식을 사거나 팔아야 할까?"
  • 포트폴리오 수준의 분석이나 관리를 포함한 모든 요청

사전 조건

Alpaca MCP 서버 설정

이 스킬을 사용하려면 Alpaca MCP 서버가 구성 및 연결되어 있어야 합니다. MCP 서버는 다음에 대한 접근 권한을 제공합니다:

  • 현재 포트폴리오 포지션
  • 계좌 자기자본 및 매수력
  • 과거 포지션 및 거래 내역
  • 보유 증권의 시장 데이터

사용되는 MCP 서버 도구:

  • get_account_info - 계좌 자기자본, 매수력, 현금 잔고 조회
  • get_positions - 모든 현재 포지션의 수량, 원가 기준, 시장 가치 검색
  • get_portfolio_history - 과거 포트폴리오 성과 데이터
  • 시장 데이터 도구 (가격 견적 및 펀더멘털 데이터)

Alpaca MCP 서버가 연결되어 있지 않은 경우, 사용자에게 알리고 references/alpaca_mcp_setup.md에서 설정 방법을 제공하세요.

워크플로

1단계: Alpaca MCP를 통한 포트폴리오 데이터 수집

Alpaca MCP 서버 도구를 사용하여 현재 포트폴리오 정보를 수집하세요:

1.1 계좌 정보 가져오기:

mcp__alpaca__get_account_info를 사용하여 다음 정보 수집:
- 계좌 자기자본 (총 포트폴리오 가치)
- 현금 잔고
- 매수력
- 계좌 상태

1.2 현재 포지션 가져오기:

mcp__alpaca__get_positions를 사용하여 모든 보유 종목 수집:
- 심볼 티커
- 보유 수량
- 평균 매수가 (원가 기준)
- 현재 시장 가격
- 현재 시장 가치
- 미실현 손익 ($ 및 %)
- 포트폴리오 내 포지션 비중 (%)

1.3 포트폴리오 히스토리 가져오기 (선택 사항):

성과 분석을 위해 mcp__alpaca__get_portfolio_history 사용:
- 과거 자기자본 가치
- 시간 가중 수익률 계산
- 최대 낙폭 분석

데이터 검증:

  • 모든 포지션에 유효한 티커 심볼이 있는지 확인
  • 시장 가치 합계가 계좌 자기자본과 일치하는지 확인
  • 부실하거나 비활성화된 포지션 확인
  • 예외 상황 처리 (소수 주식, 옵션, 암호화폐 등 지원 시)

2단계: 포지션 데이터 보강

포트폴리오의 각 포지션에 대해 추가 시장 데이터 및 펀더멘털 데이터를 수집하세요:

2.1 현재 시장 데이터:

  • 실시간 또는 지연된 가격 견적
  • 일일 거래량 및 유동성 지표
  • 52주 범위
  • 시가총액

2.2 펀더멘털 데이터: WebSearch 또는 사용 가능한 시장 데이터 API를 사용하여 다음 정보 수집:

  • 섹터 및 산업 분류
  • 주요 밸류에이션 지표 (P/E, P/B, 배당 수익률)
  • 최근 실적 및 재무 건전성 지표
  • 애널리스트 평가 및 목표 주가
  • 최근 뉴스 및 주요 개발 사항

2.3 기술적 분석:

  • 가격 추세 (20일, 50일, 200일 이동 평균)
  • 상대 강도
  • 지지 및 저항 수준
  • 모멘텀 지표 (가능한 경우 RSI, MACD)

3단계: 포트폴리오 수준 분석

참조 파일의 프레임워크를 사용하여 종합 포트폴리오 분석을 수행하세요:

3.1 자산 배분 분석

자산 배분 프레임워크는 references/asset-allocation.md 참조

여러 차원에서 현재 배분 상태를 분석하세요:

자산 클래스별:

  • 주식 vs 채권 vs 현금 vs 대체 자산
  • 사용자의 위험 프로필에 따른 목표 배분과 비교
  • 배분이 투자 목표와 일치하는지 평가

섹터별:

  • 기술, 헬스케어, 금융, 소비재 등
  • 섹터 집중 위험 식별
  • 벤치마크 섹터 비중과 비교 (예: S&P 500)

시가총액별:

  • 대형주 vs 중형주 vs 소형주 분포
  • 메가캡 집중도
  • 시가총액 분산 점수

지역별:

  • 미국 vs 해외 vs 신흥국
  • 국내 집중 위험 평가

출력 형식:

## 자산 배분

### 현재 배분 vs 목표
| 자산 클래스 | 현재 | 목표 | 차이 |
|-------------|---------|--------|----------|
| 미국 주식 | XX.X% | YY.Y% | +/- Z.Z% |
| ... |

### 섹터별 비중
[파이 차트 설명 또는 섹터별 비율 표]

### 상위 10개 보유 종목
| 순위 | 심볼 | 포트폴리오 비중 | 섹터 |
|------|--------|----------------|--------|
| 1 | AAPL | X.X% | 기술 |
| ... |

3.2 분산 투자 분석

분산 투자 이론은 references/diversification-principles.md 참조

포트폴리오 분산 투자 품질을 평가하세요:

포지션 집중도:

  • 상위 보유 종목과 전체 비중 식별
  • 단일 포지션이 포트폴리오의 10-15%를 초과하는지 플래그 표시
  • 허핀달-허쉬만 지수(HHI) 계산을 통한 집중도 측정

섹터 집중도:

  • 지배적인 섹터 식별
  • 섹터가 포트폴리오의 30-40%를 초과하는지 플래그 표시
  • 벤치마크 섹터 다양성과 비교

상관관계 분석:

  • 주요 포지션 간의 상관관계 추정
  • 상관관계가 높은 보유 종목 식별 (잠재적 중복)
  • 실제 분산 투자 이점 평가

포지션 수량:

  • 최적 범위: 개인 포트폴리오의 경우 15-30개 주식
  • 저분산(<10개 주식) 또는 고분산(>50개 주식) 플래그 표시

출력:

## 분산 투자 평가

**집중 위험:** [낮음 / 보통 / 높음]
- 상위 5개 보유 종목이 포트폴리오의 XX% 차지
- 최대 단일 포지션: [심볼] at XX%

**섹터 분산:** [매우 우수 / 우수 / 보통 / 미흡]
- 지배적 섹터: [섹터명] at XX%
- [섹터 간 균형 평가]

**포지션 수량:** [최적 / 저분산 / 고분산]
- 총 포지션: XX개 주식
- [추천]

**상관관계 우려 사항:**
- [상관관계가 높은 포지션 쌍 나열]
- [분산 투자 개선 제안]

3.3 위험 분석

위험 측정 프레임워크는 references/portfolio-risk-metrics.md 참조

주요 위험 지표를 계산하고 해석하세요:

변동성 측도:

  • 추정 포트폴리오 베타 (포지션 베타의 가중 평균)
  • 개별 포지션 변동성
  • 포트폴리오 표준 편차 (과거 데이터가 있는 경우)

하방 위험:

  • 최대 낙폭 (포트폴리오 히스토리 기준)
  • 현재 고점 대비 낙폭
  • 상당한 미실현 손실이 있는 포지션

위험 집중도:

  • 고변동성 주식 비중 (베타 > 1.5)
  • 투기적/비수익 기업 비중
  • 레버리지 사용 여부 (해당 시)

꼬리 위험:

  • 블랙 스완 이벤트 노출 가능성
  • 단일 주식 집중 위험
  • 섹터 특정 사건 위험

출력:

## 위험 평가

**전체 위험 프로필:** [보수적 / 중립적 / 공격적]

**포트폴리오 베타:** X.XX (시장 1.00 대비)
- 해석: 포트폴리오는 시장보다 [변동성이 크다/작다]

**최대 낙폭:** -XX.X% ($XXX,XXX에서 $XXX,XXX로)
- 현재 고점 대비 낙폭: -XX.X%

**고위험 포지션:**
| 심볼 | 포트폴리오 비중 | 베타 | 위험 요소 |
|--------|----------------|------|-------------|
| [티커] | XX% | X.XX | [높은 변동성 / 최근 손실 / 기타] |

**위험 집중도:**
- XX% 단일 섹터 ([섹터])
- XX% 베타 > 1.5 주식
- [기타 집중 위험]

**위험 점수:** XX/100 ([낮음 / 보통 / 높음])

3.4 성과 분석

사용 가능한 데이터를 사용하여 포트폴리오 성과를 평가하세요:

절대 수익률:

  • 전체 포트폴리오 미실현 손익 ($ 및 %)
  • 최고 성과 포지션 (상위 5개, 수익률 % 기준)
  • 최저 성과 포지션 (하위 5개, 손실률 % 기준)

시간 가중 수익률 (히스토리 사용 가능 시):

  • 연초 대비 수익률
  • 1년, 3년, 5년 연환산 수익률
  • 벤치마크와 비교 (S&P 500, 관련 지수)

포지션 수준 성과:

  • 승자 vs 패자 비율
  • 승리 포지션 평균 수익
  • 패배 포지션 평균 손실
  • 52주 최고가/최저가 근처 포지션

출력:

## 성과 검토

**총 포트폴리오 가치:** $XXX,XXX
**총 미실현 손익:** $XX,XXX (+XX.X%)
**현금 잔고:** $XX,XXX (포트폴리오의 XX%)

**최고 성과 종목:**
| 심볼 | 수익 | 포지션 가치 |
|--------|------|----------------|
| [티커] | +XX.X% | $XX,XXX |
| ... |

**최저 성과 종목:**
| 심볼 | 손실 | 포지션 가치 |
|--------|------|----------------|
| [티커] | -XX.X% | $XX,XXX |
| ... |

**벤치마크 대비 성과 (가능한 경우):**
- 포트폴리오 수익률: +X.X%
- S&P 500 수익률: +Y.Y%
- 알파: +/- Z.Z%

4단계: 개별 포지션 분석

주요 포지션(포트폴리오 비중 기준 상위 10-15개)에 대해 상세 분석을 수행하세요:

포지션 분석 프레임워크는 references/position-evaluation.md 참조

각 중요 포지션에 대해:

4.1 현재 투자 논리 검증:

  • 이 포지션이 왜 시작되었는가? (사용자 컨텍스트에서 알 수 있는 경우)
  • 투자 논리가 실현되었거나 깨졌는가?
  • 최근 회사 개발 및 뉴스

4.2 밸류에이션 평가:

  • 현재 밸류에이션 지표 (P/E, P/B 등)
  • 과거 밸류에이션 범위와 비교
  • 섹터 동종 업계와 비교
  • 고평가 / 적정 / 저평가 평가

4.3 기술적 건전성:

  • 가격 추세 (상승, 하락, 횡보)
  • 이동 평균 대비 포지션
  • 지지 및 저항 수준
  • 모멘텀 상태

4.4 포지션 규모:

  • 포트폴리오 내 현재 비중
  • 신념과 위험을 고려할 때 적절한 규모인가?
  • 최적 대비 과대 또는 과소 비중

4.5 실행 추천:

  • 보유 - 포지션 규모가 적절하고 논리가 유효함
  • 추가 매수 - 기회 대비 과소 비중, 논리 강화 중
  • 일부 매도 - 과대 비중 또는 밸류에이션 부담
  • 전량 매도 - 논리 붕괴, 다른 더 나은 기회 있음

포지션별 출력:

### [심볼] - [회사명] (포트폴리오의 XX.X%)

**포지션 세부 정보:**
- 주식 수: XXX
- 평균 매입가: $XX.XX
- 현재 가격: $XX.XX
- 시장 가치: $XX,XXX
- 미실현 손익: $X,XXX (+XX.X%)

**펀더멘털 요약:**
- 섹터: [섹터]
- 시가총액: $XX.XB
- P/E: XX.X | 배당 수익률: X.X%
- 최근 개발 사항: [주요 뉴스 또는 실적]

**기술적 상태:**
- 추세: [상승 / 하락 / 횡보]
- 가격 vs 50일 이동평균선: [위/아래 XX%]
- 지지: $XX.XX | 저항: $XX.XX

**포지션 평가:**
- **논리 상태:** [유효 / 약화 / 붕괴 / 강화]
- **밸류에이션:** [저평가 / 적정 / 고평가]
- **포지션 규모:** [최적 / 과대 비중 / 과소 비중]

**추천:** [보유 / 추가 매수 / 일부 매도 / 전량 매도]
**근거:** [1-2문장 설명]

5단계: 리밸런싱 추천

리밸런싱 접근법은 references/rebalancing-strategies.md 참조

구체적인 리밸런싱 추천을 생성하세요:

5.1 리밸런싱 트리거 식별:

  • 목표 비중에서 크게 벗어난 포지션
  • 조정이 필요한 섹터/자산 클래스 할당
  • 일부 매도할 과대 비중 포지션 (임계값 초과)
  • 추가할 과소 비중 영역 (임계값 미만)
  • 세금 고려 사항 (자본 이득 영향)

5.2 리밸런싱 계획 수립:

일부 매도할 포지션:

  • 과대 비중 포지션 (>목표 대비 임계값 이상)
  • 크게 상승한 주식 (밸류에이션 우려)
  • 포트폴리오의 15-20%를 초과하는 집중 포지션
  • 논리가 붕괴된 포지션

추가 매수할 포지션:

  • 비중이 낮은 섹터 또는 자산 클래스
  • 현재 과소 비중인 고신념 포지션
  • 분산 투자 개선을 위한 새로운 기회

현금 배치:

  • 잉여 현금이 있는 경우 (포트폴리오의 10% 초과), 배치 제안
  • 기회와 할당 격차에 따라 우선순위 지정

5.3 우선순위 지정: 리밸런싱 조치를 우선순위별로 정렬:

  1. 즉시 - 위험 감소 (집중 포지션 일부 매도)
  2. 높은 우선순위 - 주요 할당 이탈 (목표 대비 10% 초과)
  3. 중간 우선순위 - 중간 정도 이탈 (목표 대비 5-10%)
  4. 낮은 우선순위 - 미세 조정 및 기회적 조정

출력:

## 리밸런싱 추천

### 요약
- **리밸런싱 필요:** [예 / 아니오 / 선택 사항]
- **주된 이유:** [집중 위험 / 섹터 이탈 / 현금 배치 / 기타]
- **예상 거래:** X 매도 주문, Y 매수 주문

### 권장 조치

#### 높은 우선순위: 위험 감소
**[심볼] 일부 매도** 포트폴리오의 XX%에서 YY%로
- **매도할 주식 수:** XX주 (~$XX,XXX)
- **근거:** [과대 비중 / 밸류에이션 확대 / 기타]
- **세금 영향:** $X,XXX 자본 이득 (추정)

#### 중간 우선순위: 자산 배분
**[섹터/자산 클래스] 비중 확대**
- **목표:** XX%에서 YY%로 증가
- **추천 종목:** [종목1, 종목2, 종목3]
- **투자할 금액:** ~$XX,XXX

#### 현금 배치
**현재 현금:** $XX,XXX (포트폴리오의 XX%)
- **추천:** [배치 / 기회를 위해 보유 / X%로 축소]
- **제안된 배분:** [섹터/종목별 분배]

### 실행 계획
1. [첫 번째 조치 - 최우선 순위]
2. [두 번째 조치]
3. [세 번째 조치]
...

**시점 고려 사항:**
- [세금 연말 정산 / 실적 시즌 / 시장 상황]
- [해당되는 경우 단계별 제안]

6단계: 포트폴리오 보고서 생성

저장소 루트에 저장할 종합 마크다운 보고서를 생성하세요:

파일명: portfolio_analysis_YYYY-MM-DD.md

보고서 구조:

# 포트폴리오 분석 보고서

**계좌:** [가능한 경우 계좌 유형]
**보고서 작성일:** YYYY-MM-DD
**포트폴리오 가치:** $XXX,XXX
**총 손익:** $XX,XXX (+XX.X%)

---

## 요약

[주요 결과 3-5가지 요약]
- 전체 포트폴리오 건전성 평가
- 주요 강점
- 주요 위험 또는 우려 사항
- 주요 추천 사항

---

## 보유 종목 개요

[모든 포지션 요약 표]

---

## 자산 배분
[3.1단계 섹션]

---

## 분산 투자 분석
[3.2단계 섹션]

---

## 위험 평가
[3.3단계 섹션]

---

## 성과 검토

[이하 내용은 원문과 동일하게 유지]

---

## 개별 포지션 분석
[4단계 섹션]

---

## 리밸런싱 추천
[5단계 섹션]

---

## 면책 조항

이 보고서는 정보 제공 목적으로만 제공되며 투자 조언이 아닙니다. 투자 결정을 내리기 전에 자격을 갖춘 재무 전문가와 상담하세요.

모범 사례

  1. 데이터 정확성: Alpaca MCP 응답을 검증하고 정확성을 확인한 후 분석 진행
  2. 사용자 선호도: 가능하면 사용자의 위험 허용 범위 및 투자 선호도 파악
  3. 목표 기준: 밸류에이션 및 배분 평가 시 관련 벤치마크 및 목표 사용
  4. 실행 가능한 인사이트: 각 추천에 대한 명확한 근거 제공
  5. 세금 인식: 특히 장기 보유 포지션의 경우 세금 영향을 고려
  6. 보수적 언어: 시장 예측 시 가정과 한계를 명확히 명시
  7. 감정적 거래 방지: 두려움이나 탐욕보다는 데이터에 기반한 추천

스킬 메타데이터

  • 소스: leecyno1/boutique-skills
  • 카테고리: 금융 분석
  • API 통합: Alpaca MCP 서버
  • 필수 참조 파일:
    • references/asset-allocation.md
    • references/diversification-principles.md
    • references/portfolio-risk-metrics.md
    • references/position-evaluation.md
    • references/rebalancing-strategies.md

Individual skills in this repo

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

leecyno1/boutique-skills

Review fixed income portfolios by pricing multiple bonds, retrieving reference data, analyzing cashflows, and running scenario analysis. Use when reviewing bond portfolios, computing portfolio duration and DV01, analyzing cashflow waterfalls, stress testing rate scenarios, or assessing portfolio composition.

leecyno1/boutique-skills

Track and analyze portfolio company performance against plan. Ingests monthly/quarterly financial packages (Excel, PDF), extracts KPIs, flags variances to budget, and produces summary dashboards. Use when reviewing portfolio company financials, preparing board materials, or monitoring covenant compliance. Triggers on "review portfolio company", "monthly financials", "how is [company] performing", "covenant check", or "portfolio update".

leecyno1/boutique-skills

Analyze portfolio allocation drift and generate rebalancing trade recommendations across accounts. Considers tax implications, transaction costs, and wash sale rules. Triggers on "rebalance", "portfolio drift", "allocation check", "rebalancing trades", or "my portfolio is out of balance".

leecyno1/boutique-skills

Router skill for LLMQuant portfolio-lab workflows. Use when the user needs portfolio exposure maps, what-if simulations, scenario states, or virtual portfolio comparisons.

leecyno1/boutique-skills

Router skill for LLMQuant portfolio workflows. Use when the user needs company profiles, thesis tracking, theme research, watchlist monitoring, or alert management.

leecyno1/boutique-skills

Best practices for Remotion - Video creation in React

leecyno1/boutique-skills

Agent skill at skills/default/video-autopilot-kit/SKILL.md

관련 스킬