algo-investor-skills: 사기 방지형 투자자 제안서를 만들어 주는 Claude Code 스킬

외부 자본을 유치해 보려 한 적이 있는 알고트레이더라면 누구나 그 벽을 안다. 실제로 작동하는 전략이 있고, 본인 계좌에서 쌓은 라이브 트랙 레코드가 있고, 깔끔한 자산 곡선이 있다. 그런데 막상 투자자용 문서를 쓰려고 앉으면, 가장 어려운 부분이 전략이 아니라는 사실을 깨닫게 된다. 가장 어려운 것은 숫자에 밝고 회의적인 전문가에게 당신이 사기꾼이 아니라는 점을 납득시키는 일이다. 그들은 당신의 말을 그냥 믿어 주지 않는다. 2026년에 그들이 실제로 하는 일은, 당신의 상업 제안서를 아무 맥락 없이 LLM에 붙여 넣고 이렇게 묻는 것이다. "이게 진짜야, 아니면 사기야?"

algo-investor-skills는 바로 그 순간을 위해 만들어진 기성 Claude Code 스킬 모음이다. 이것은 당신을 전략의 원시 사실에서 완성된, 감사를 거친, 다국어 투자자 제안서로 이끈다 — 그 적대적인 LLM 붙여 넣기 테스트를 견뎌 내는, 신뢰할 수 있고 정직을 앞세운 문서 말이다. 전체 설계는 타협 불가능한 하나의 규칙 위에 놓여 있다. 결코 숫자를 조작하지 않는다.

미리 한마디, 저장소가 첫머리에 내세우는 것과 같은 말이다. 이 키트의 reference/ 디렉터리에 있는 모든 것은 익명화된 작성 예시다. 이름, 거래소, 지표는 자리표시자일 뿐 실제 수치가 아니다. 스킬은 당신 자신의 측정된 트랙으로부터 문서를 생성한다 — 누군가의 실제 숫자를 함께 제공하지 않으며, 당신의 숫자를 지어내지도 않는다.

이것이 템플릿이 아니라 스킬 모음인 이유

투자자 제안서는 Word 템플릿으로도 쓸 수 있다. 실제로 사람들은 그렇게 하고, 그게 티가 난다. 정적 템플릿은 당신이 거래 마흔 건을 추가했을 때 샤프 지수를 다시 계산해 주지 못하고, 상위 승리 거래를 제거한 채 당신의 엣지를 스트레스 테스트해 주지 못하며, 적대적인 자금 배분자를 흉내 내어 당신의 피치에 있는 약점을 찾아 주지도 못한다. 바로 그 공백을 algo-investor-skills가 채운다.

이것들은 .claude/skills/ 아래에 자리잡는 평범한 Claude Code 스킬이다. 저장소를 Claude Code에서 열면 자동으로 로드된다. 평범한 스킬이기 때문에 다른 프로젝트로 그대로 옮길 수도 있다 — 폴더를 프로젝트 로컬 .claude/skills/로 복사하거나, 어디서나 쓸 수 있도록 사용자 전역 ~/.claude/skills/로 복사하면 된다.

cp -r .claude/skills/* /path/to/your/project/.claude/skills/

cp -r .claude/skills/* ~/.claude/skills/

금융 모델 엔진은 의존성 없이 독립 실행도 가능해서, 정상 동작 점검용으로 쓸 수 있다.

node .claude/skills/algo-financial-models/models.mjs   # prints a worked demo

여섯 개의 스킬

이 키트는 조합 가능한 여섯 개의 스킬을 제공한다. 하나는 오케스트레이터이고, 나머지 다섯 개는 각각 파이프라인의 한 단계를 담당한다.

파이프라인, 처음부터 끝까지

스킬은 무작위로 골라 쓰는 메뉴가 아니다 — 순서가 정해진 파이프라인을 이루며, 각 단계가 그 앞 단계에 의존하기 때문에 investor-docs가 이를 순서대로 실행한다.

intake/intake-template.md   ← you fill in measured facts + labeled assumptions
        │
        ▼
algo-financial-models   →   honest numbers / tables
        │
        ▼
investor-proof-pack     →   transparency + verification package
        │
        ▼
investor-proposal-build →   full 14-section Markdown proposal
        │
        ▼
investor-doc-localize   →   language / market variants   (optional)
        │
        ▼
investor-proposal-audit →   skeptical-investor loop until it passes  (REQUIRED)

1. Intake —단일 진실 공급원

모든 것은 intake/intake-template.md에서 시작한다. 당신은 전략 논지, 측정된 트랙(표본 크기, 승률, 평균 거래, 샤프, 소르티노, 최대 낙폭, 기간 범위), 거래소와 계좌 구조, 그리고 상업적 조건을 채워 넣는다. 결정적으로, 모든 수치를 [real](측정됨)로 표시하거나, 명확히 라벨링된 전향적 가정(레버리지, 트랜치 수, 가정한 깊이, 슬리피지, 알파 감쇠)으로 표시한다.

키트 전체를 신뢰할 수 있게 만드는 규칙이 바로 여기에 있다. 비워 둔 것은 무엇이든 초안에서 명시적인 TODO 슬롯이 되며, 결코 지어낸 숫자가 되지 않는다. 거래소 내보내기 자료로 어떤 수치를 뒷받침할 수 없다면, 당신은 그것을 비워 두고, 키트는 그 공백을 덮어 가리기를 거부한다.

2. algo-financial-models — 정직한 숫자

이 스킬은 당신의 측정된 입력을 여섯 개의 정량 모델로 변환하며, 각각 정직한 한두 줄짜리 캡션이 달린 곧바로 쓸 수 있는 Markdown 표로 출력한다.

• 기댓값과 사이징 — 기댓값, 거래당 시그마, 손익비, 수용량, 순 엣지, 그리고 Kelly 비율.
• 수익 브리지 — 원시 이벤트당 엣지에서 수용량 조정·수수료 차감·감쇠 차감 수치까지 네 단계. 이것은 항상 원시 엣지와 수용량 조정 엣지를 둘 다 보여 주는데, 원시 이벤트당 숫자는 펀드 차원에서 실현 가능한 수익이 아니며, 그렇지 않은 척하는 것이야말로 이 키트가 막으려고 존재하는 바로 그런 종류의 부정직함이기 때문이다.
• 하이워터마크 수수료 체계 — 성과 수수료만, 자산이 신고점을 경신할 때만 부과된다.
• 퀀트 지표 — 측정된 샤프와 소르티노가 정확히 재현되도록 시그마와 하방 편차를 역산한다. 이것들은 그대로 통과되는 값이다. 키트는 이를 덮어쓰거나 부풀리지 않는다.
• 몬테카를로 (GBM) — P5 / P50 / P95 경로와 파산 확률, 알파 감쇠를 포함해서.
• 알파 지속성 + Wilson CI — 감쇠하는 엣지 체계와 소표본 승률 신뢰 구간으로, 80거래 중 62%라는 수치를 마치 자연 법칙인 양 제시하는 일이 결코 없도록 한다.

내가 정말 날카롭다고 느낀 디테일 하나는, 실효 이벤트당 노출이 leverage / tranches(L / N)로 계산되고, 노출 스윕 표가 Kelly를 기준으로 색깔로 구분된다는 점이다 — 절반 Kelly 이하이면 초록색, 전체 Kelly까지는 노란색, 그 이상이면 빨간색. 그것은 "얼마나 베팅해야 하나?"를 막연한 느낌에서 변호할 수 있는 표로 바꿔 놓는다.

3. investor-proof-pack — 확인 가능하게 만든 정직함

이것이 회의론자들이 실제로 신경 쓰는 부분이다. 증빙 패키지는 비법을 흘리지 않으면서도, 아무것도 지어내지 않으면서, 당신의 라이브 트랙이 진짜임을 입증하는 투명성 패키지를 조립한다.

• 고정된 열(# | Venue | Pair | Date | Side | PnL % | Hold time | Status)을 가진 공개 거래 표로, 해당 기간의 모든 거래 — 승리 거래와 패배 거래를 함께 — 나열한다. 체리피킹은 명시적으로 금지된다. 비율과 날짜는 표시되고, 달러 금액은 의도적으로 보류되며, 키트는 그 경계를 분명한 말로 밝힌다.
• 서로 일치해야 하는 두 경로를 가진 독립 대사 방법론. 하나는 거래소 REST API를 통한 주문 ID 대사(체결에서 실현 손익을 정확히 다시 계산)이고, 다른 하나는 거래소의 공식 거래 내역 내보내기 자료와의 명세서 대사(명시된 허용 오차 내에서 심볼 + 시간 + 부호로 매칭)다. 서로 일치하는 두 개의 독립 대사는 하나보다 위조하기가 훨씬 더 어렵다.
• 읽기 전용 "Step 0" 검증 제안. 투자자가 직접 생성한 읽기 전용 API 키로 스스로 실행하는 스크립트로, 거래 권한 키를 부여하기 전에 거래소 자체 데이터와 공개 거래를 대사한다.
• 차트 — (거래 메커니즘을 설명하기 위해 명확히 라벨링된) 합성 예시와 함께, 대사된 체결에 연결된 진입/청산 표시가 달린 실제 캔들별 차트.

그리고 이것을 피치 덱과 구분 짓는 부분은, 증빙 패키지가 자신의 경계를 소리 내어 명시한다는 점이다. 대사는 과거 라이브 거래의 진정성과 규모를 입증한다. 그것은 미래 수익을 입증하지 않고, 대규모에서 엣지가 유지됨을 입증하지 않으며, 완전한 감사도 아니다. 가장 강력한 증거는 투자자 본인 계좌에서의 전향적 파일럿이라고 키트는 분명하게 말한다.

4. investor-proposal-build — 14개 섹션의 흐름

이 스킬은 적대적인 투자자가 통째로 LLM에 붙여 넣어 낱낱이 뜯어볼 수 있는, 단일하고 자기 완결적인 Markdown 문서를 조립한다. 구조는 수익이 아니라 리스크와 수탁(custody)을 앞세우는 의도적인 14개 섹션의 흐름이다.

1. 논지 — 맨 첫 단락에 수탁 앵커를 한 줄로 담아.
2. 엣지가 어디서 오는가 — 구조적 비효율성, 외부 연구를 운영자 본인의 성과로 제시하지 않는다는 정직한 단서와 함께.
3. 핵심 지표 — 샤프 / 소르티노 / 최대 낙폭, 레버리지 불변 비율로 표기하고, 소르티노를 앞세우며, 소표본 단서를 첨부해서.
4. 수탁 및 운영 모델 — 거래 전용 API 키, 출금 권한 없음, "비상 브레이크"로서의 원클릭 취소, 유일하게 제공되는 모델로 명시.
5. 실거래 투명성 — 3단계의 증빙 패키지.
6. 자본 단계 — 파일럿(~$50k, 수수료는 에스크로, 하이워터마크가 회복될 때까지 0%), 확장, 그리고 목표.
7. 수수료 모델 — 순 이익의 백분율로 표시한 구체적인 성과 수수료, 하이워터마크 적용, 그리고 운용 수수료는 없음.
8. 명시된 두 가지 리스크 — 대규모 미검증(출구 유동성)과 초단기 보유 구간, 얼버무림 없이 명시.
9. 정량화된 실패 시나리오 표 — 각 시나리오에서 투자자가 잃는 것, N-트랜치 계산에 연결해서.
10. 책임과 리스크 배분 — 법인 부재 / 제한적 상환청구권이라는 정직한 단서를 포함해서.
11. N개의 별개의 최상위 계좌(동결 시 연쇄될 수 있는 서브계좌가 아니라)에 걸친 자본 분할, 거래소별 상한과 함께.
12. 알파 지속성 — 명시적인 감쇠 가정과 수용량 한도, 전향적 가정으로 틀 지어서.
13. 운영자 — 한 사람, 책임 소재가 한 명에게 집중, 정렬(alignment) 강점이자 동시에 핵심 인물 리스크로 명시.
14. 로드맵 — 명시적으로 "약속이 아님"으로 라벨링.

이 전체는 설계상 과장을 억제한다. 어떤 문장이 피치 덱처럼 들리면, 스킬은 그것을 잘라낸다. 수탁과 비상 브레이크는 어떤 수익 수치보다 먼저 나오고, 자랑처럼 읽힐 수 있는 모든 섹션은 같은 호흡 안에서 그에 상응하는 리스크로 균형을 맞춘다.

5. investor-doc-localize — 흔들림 없는 번역

선택 사항이지만 잘 설계되어 있다. 이것은 완성된 마스터를 en / ru / zh / ko(확장 가능)로 현지화하고, 시장별 변형까지 만들어 낸다 — 예를 들어, 거래소를 직접 아는 청중을 위해 구조적 엣지를 드러내는 격리 시장 변형과, 정제된 공개 변형을 대비시킨다. 이것이 경계하는 큰 죄는, 다른 언어로 "더 잘 읽힌다"는 이유로 숫자가 흔들리거나 단서가 무뎌지게 두는 것이다. 모든 수수료 백분율, 모든 수탁 조건, 모든 실패 시나리오는 언어 전반에 걸쳐 동일하게 표현되며, 수탁·수수료·책임 섹션에 대해서는 역번역 점검을 곁들인다.

6. investor-proposal-audit — 필수 게이트

이것이 이 키트를 단순한 문서 생성기 이상으로 만드는 스킬이다. 진지한 투자자가 수행하는 바로 그 점검을 시뮬레이션한다. 새로운, 문서만 보는 AI 투자자가 — 코드도, 트랙 레코드도, 선의의 해석도 없이 — 제안서를 읽고 구조화된 판정을 내놓는다. satisfaction(0–100), wouldInvest, scamRisk(낮음 / 중간 / 높음), 주요 우려 사항, 누락 정보, 위험 신호, 그리고 강점. 그런 다음 수정 에이전트가 회의론자가 표시한 것을 — 정직하게 — 고치고, 루프가 반복된다.

채점 기준은 기본값이 회의주의다. 그것은 정직한 한계, 구체적인 검증 메커니즘, 명시적인 수수료 및 수탁 조건, 그리고 정량화된 하방을 보상한다. 그리고 가차 없이 감점한다. 마케팅 형용사, 숫자를 숨긴 채 "우리를 믿으세요", 돈에 관한 모호함, 검증 불가능한 주장, 그리고 내부 모순 — 그 전형적인 예가 이벤트당 수용량이 작다고 인정하면서 큰 금액을 요청하는 것이다.

수정 에이전트의 규칙이 이 키트 전체의 도덕적 핵심이다. 그것은 결코 지표를 부풀리지 않고, 결코 단서를 삭제하지 않으며, 결코 트랙 레코드를 조작하지 않는다. "검증 불가능"을 고치는 방법은 제시 가능한 증거를 더하는 것 — 읽기 전용 API 접근, 거래소 내보내기 명세서, 소규모 유료 파일럿, 성과 수수료 에스크로 — 이지 과장하는 것이 아니다. 문서는 적어도 두 번의 반복 후 satisfaction >= 88이고 scamRisk가 high가 아닐 때에만 "완료"된다. 이 감사를 통과하지 못한 제안서는, 정의상 결과물이 아니라 초안이다.

설계 원칙 (그리고 그것이 자금 배분자에게 중요한 이유)

저장소는 타협 불가능한 네 가지 원칙을 명시하며, 이는 정직한 자금 모집을 위한 선언문으로 읽을 만하다.

• 결코 조작하지 않는다. 모든 숫자는 측정된 데이터나 명확히 라벨링된 전향적 가정으로 거슬러 올라간다. 빠진 사실은 지어낸 수치가 아니라 눈에 보이는 TODO 슬롯이 된다.
• 정직 우선, 과장 억제. 리스크와 수탁을 앞세운다. 한계를 명시한다. 신뢰를 요구하는 대신 검증을 제안한다.
• 수탁은 구조적이지 약속이 아니다. 투자자 소유 계좌의 거래 전용 API 키, 출금 권한 없음, 원클릭으로 취소 가능.
• 감사 게이트는 필수다. 회의적 투자자 루프를 통과하기 전까지 문서는 완료되지 않는다.

알고트레이딩 피치를 읽으면서 미사여구가 나올 때마다 회의심이 솟구치는 것을 느껴 본 적이 있다면, 이 역발상이 왜 통하는지 이해할 것이다. 신뢰는 더 많이 주장함으로써 쌓이는 것이 아니다. 그것은 당신이 입증할 수 있는 것을 정확히 주장함으로써, 그리고 독자에게 스스로 확인할 도구를 건네줌으로써 쌓인다.

알고 투자자가 실제로 이것을 사용하는 방법

실제로 작업 흐름은 짧다.

1. 저장소를 Claude Code에서 열어 스킬이 자동 로드되게 한다.
2. intake 템플릿을 복사해, 측정된 트랙과 명시적으로 라벨링된 전향적 가정으로 채우되, 데이터가 없는 곳은 비워 둔다.
3. Claude에게 이렇게 요청한다. "내 전략을 위한 투자자 문서를 준비해 줘." 그러면 investor-docs 오케스트레이터가 작동해, 파이프라인을 처음부터 끝까지 실행한다.
4. 감사 게이트가 마지막에 실행되어, satisfaction이 충분히 높고 scam-risk가 더 이상 높지 않을 때까지 루프를 돈다.

결과로 얻는 것은 단일 Markdown 파일이다. 이식 가능하고, 자기 완결적이며, 어차피 실제 자금 배분자가 들이댈 LLM 붙여 넣기 테스트를 견디도록 만들어졌다.

이것이 Marketmaker / AI 에이전트 생태계에서 자리하는 곳

우리는 이 블로그에서 트레이딩 결정을 내리는 AI 에이전트에 대해 많이 써 왔다 — 멀티 에이전트 펀드, LLM 애널리스트 위원회, 강화 학습 생태계. algo-investor-skills는 한 겹 더 바깥에서, 그런 프로젝트들이 대체로 무시하는 문제 위에 놓인다. 자동화된 전략이 일단 작동하면, 그것을 자본에게 어떻게 신뢰할 수 있게 전달할 것인가? 이것은 신호 생성이 아니라 투자자 관계와 실사를 겨냥한 에이전트형 AI 패턴이다. 오케스트레이터 + 전문가들 형태 — 순서를 정하는 한 개의 스킬, 각각 한 단계를 담당하는 여러 개 — 는 우리가 계속 승리하는 것을 보아 온 바로 그 조합형 에이전트 아키텍처이며, 여기서는 오더북이 아니라 문서화와 검증 파이프라인에 적용되었다.

진지한 알고트레이더에게 그것은 의미 있는 인프라 한 조각이다. 전략은 당신의 엣지이고, 감사를 거친 정직 우선 제안서는 당신이 마케터가 되거나 신뢰성을 타협하지 않고도 그 엣지가 자본을 끌어모으게 해 주는 것이다. 키트의 입장 — 신뢰보다 검증, 수익보다 리스크, 결코 조작된 숫자 없음 — 은 바로 전문 자금 배분자와의 접촉에서 살아남는 입장이다.

정직한 단서들

이것은 초기 단계의, 단독 메인테이너 프로젝트이며, 저장소도 그렇게 말한다. 참조 제안서와 모델은 익명화된 예시일 뿐 실제 수치가 아니다 — 키트의 가치는 함께 제공되는 어떤 숫자가 아니라 과정과 규율에 있다. 감사 루프는 그것을 실행하는 모델만큼만 좋고, 종이 위의 통과 점수는 여전히 종이 점수다. 키트 자신이 강조하듯, 가장 강력한 증거는 언제나 투자자 본인 계좌에서의 전향적 파일럿이다. 키트는 문서를 만들어 낼 뿐, 금융·법률·세무 조언을 하지 않으며, 과거나 백테스트 결과는 미래를 보장하지 않는다.

그 어느 것도 핵심 아이디어를 약화시키지 않는다. 투자자 문서를 준비하는 어렵고 정직한 작업 — 재현 가능한 숫자 계산, 확인 가능한 증빙 패키지 구축, 리스크를 앞세우기, 그리고 적대적인 검토에서 살아남기 — 이야말로 이 키트가 체계화하는 바로 그 작업이다.

링크

• GitHub: suenot/algo-investor-skills

결론

algo-investor-skills는 작은 저장소이지만 유난히 규율 잡힌 논지를 담고 있다. 알고트레이딩 전략을 위해 자본을 유치하는 방법은 더 세게 피치하는 것이 아니라 확인 가능하게 정직한 것이라는 논지다. 여섯 개의 Claude Code 스킬이 그 논지를 파이프라인으로 바꾼다 — 측정된 사실 투입, 재현 가능한 숫자, 검증 가능한 증빙 패키지, 리스크 우선의 14개 섹션 제안서, 선택적인 충실한 현지화, 그리고 과장이 아니라 증거를 더함으로써 약점을 고치는 필수 회의적 투자자 감사.

실제 전략을 운용하고 있고 투자자 문서라는 벽에서 멈춰 본 적이 있다면, 이것은 오후 한나절을 들일 가치가 있다. intake를 채우고, 오케스트레이터를 실행하고, 회의론자가 당신의 초안을 물어뜯게 하고, 당신이 입증할 수 있는 것을 정확히 말하는 — 그리고 독자에게 그것을 확인할 도구를 건네는 — 문서를 출하하라.