Communitygithub.com

ComeOnOliver/skillshub

Portfolio Buddy 2 개발을 위한 자동 로딩 컨텍스트. React 19 개발, TypeScript, 포트폴리오 분석 기능, 지표 계산, 트레이딩 전략 비교, 또는 Portfolio Buddy 2 코드베이스 작업 시 사용하세요. 기술 스택, 알려진 문제, 아키텍처 제약 사항을 포함합니다.

skillshub란 무엇인가요?

이 스킬은 Portfolio Buddy 2라는 포트폴리오 분석 도구의 전체 프로젝트 컨텍스트를 AI 에이전트에 제공합니다. React 19, TypeScript, Vite, Tailwind CSS, Chart.js, Supabase 등 사용된 기술 스택을 명확히 정의하여 에이전트가 올바른 도구와 라이브러리를 사용하도록 안내합니다. 또한, 200라인을 초과하는 과도하게 큰 컴포넌트, 15개의 `any` 타입 위반, 제거되지 않은 미사용 의존성(Recharts)과 같은 알려진 기술 부채와 버그를 문서화하여 에이전트가 이를 인지하고 개선 작업을 수행하도록 돕습니다. 최근 추가된 Sortino 비율 계산, 날짜 범위 필터링, 고급 다중 열 정렬과 같은 기능의 위치와 구현 세부 사항을 포함하여 에이전트가 코드베이스를 정확히 이해하고 수정할 수 있게 합니다. Claude Code, Cursor, Codex와 같은 AI 코딩 에이전트에서 이 스킬을 사용하면 개발 컨텍스트를 유지한 채 포트폴리오 분석 기능 개발 및 유지보수를 효율적으로 수행할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/5minfutures/portfolio-context

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

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

문서

Portfolio Buddy 2 - 프로젝트 컨텍스트

기술 스택

  • 프론트엔드: React 19, TypeScript, Vite
  • UI: Tailwind CSS, shadcn/ui (색상 시스템만)
  • 차트: Chart.js, react-chartjs-2, chartjs 플러그인 (zoom, annotation, date adapter)
  • 상태 관리: 일반 React (useState, useMemo, useCallback)
  • 데이터 유틸리티: date-fns (날짜 조작)
  • 백엔드: Supabase (PostgreSQL)
  • 배포: Cloudflare Pages

프로젝트 목적

투자자 및 선물 트레이더를 위한 포트폴리오 분석 도구:

  • 트레이딩 전략을 벤치마크 자산(SPY, GLD)과 비교
  • 자산 간 상관 관계 행렬 계산 (Spearman 및 Pearson)
  • 위험 지표 및 성과 분석 (Sharpe, Sortino, 최대 낙폭 등)
  • CSV를 통한 거래 데이터 업로드 및 결과 시각화
  • 선물 거래를 위한 계약 승수 적용으로 지표 조정
  • 특정 기간 분석을 위한 날짜 범위 필터링

알려진 문제 및 기술 부채

현재 기술 부채

  1. 사용하지 않는 의존성: Recharts (11.5KB)가 설치되었지만 한 번도 임포트되지 않음

    • package.json에서 제거해야 함
    • 현재 Chart.js를 대신 사용 중
  2. 과도하게 큰 컴포넌트: 200라인 기준 위반

    • PortfolioSection.tsx (591줄) → 하위 컴포넌트로 리팩토링 필요
    • App.tsx (351줄) → 섹션을 컴포넌트로 추출 필요
    • MetricsTable.tsx (242줄) → 개선되었지만 여전히 제한 초과
  3. TypeScript 위반: any 타입 15건

    • usePortfolio.ts: 거래/지표 타입에 11건 발생
    • useMetrics.ts: 정렬 비교에 4건 발생
    • dataUtils.ts: Metrics 인터페이스에 1건 발생

알려진 버그

  1. Supabase 업로드 오류: 대용량 업로드 시 간헐적인 500 오류
    • 커밋 9fb7fdb에서 향상된 오류 처리 추가
    • 업로드 훅의 오류 처리 확인
    • 무료 티어의 행 제한 초과 여부 확인

최근 추가된 기능

  • Sortino 비율 계산 (커밋 258ba3a, 9f25040)
    • 위치: PortfolioSection.tsx에 인라인 구현 (133-158줄)
    • 사용자 지정 무위험 수익률을 위한 입력 상태
    • sqrt(365) 계수를 사용한 연간화된 하방 편차
    • 올바른 분산 계산 (전체 수익률, 음수만이 아님으로 나눔)
    • 포트폴리오 통계 섹션에 표시 (535줄)
    • 참고: dataUtils.ts에 없음 - 포트폴리오 수준 컨텍스트로 인해 컴포넌트에 유지
  • 날짜 범위 필터링 (커밋 258ba3a)
    • 시작/종료 날짜로 포트폴리오 데이터 필터링
    • usePortfolio 훅에 구현됨
  • 고급 다중 열 정렬 (useSorting 훅)
    • 우선 순위로 여러 열 정렬
    • 열별 사용자 지정 비교 로직

아키텍처 제약 사항

  • 컴포넌트 제한: 컴포넌트당 최대 200줄 (현재 3개 컴포넌트 위반)
  • 훅 패턴: /src/hooks/의 사용자 정의 훅
  • 유틸 패턴: /src/utils/의 순수 함수
  • 타입 안전성: 엄격한 TypeScript, any 타입 없음 (기술 부채로 15건 위반)
  • 상태 관리: 일반 React 훅만 사용 - Zustand 또는 TanStack Query 사용 금지

주요 컴포넌트 구조

src/
├── components/
│   ├── AnalyticsControls.tsx     (Metrics/Portfolio/Correlation 보기 전환)
│   ├── ContractInput.tsx         (계약 승수 입력)
│   ├── CorrelationHeatmap.tsx    (상관 관계 시각화)
│   ├── CorrelationSection.tsx    (상관 관계 분석 래퍼)
│   ├── CustomTooltip.tsx         (차트 툴팁)
│   ├── ErrorList.tsx             (오류 표시)
│   ├── Header.tsx                (앱 헤더)
│   ├── MasterContractControl.tsx (모든 항목에 계약 값 적용)
│   ├── MetricsTable.tsx          (지표 표시 및 선택)
│   ├── PortfolioSection.tsx      (포트폴리오 차트 및 분석 - 591줄!)
│   ├── SessionComplete.tsx       (완료 UI)
│   ├── SortableHeader.tsx        (정렬 표시기가 있는 테이블 헤더)
│   ├── UploadedFilesList.tsx     (업로드된 파일 목록)
│   └── UploadSection.tsx         (Supabase로 파일 업로드)
├── hooks/
│   ├── useContractMultipliers.ts (계약 승수 관리)
│   ├── useMetrics.ts             (거래 지표 계산)
│   ├── usePortfolio.ts           (포트폴리오 데이터 및 날짜 필터링)
│   └── useSorting.ts             (고급 다중 열 정렬)
└── utils/
    └── dataUtils.ts              (지표 계산, CSV 파싱, 상관 관계)

마이그레이션 컨텍스트

이전 앱에서 40개의 기능을 마이그레이션 중 (35/40 완료). 자세한 내용은 migration-tracker 스킬을 참조하세요.

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

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.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Next.js 16+ uses App Router with Server Components by default. Client Components are only used when interactivity is needed (hooks, event handlers, browser APIs).

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

관련 스킬