Communitygithub.com

ComeOnOliver/skillshub

Automatisch geladener Kontext für die Entwicklung von Portfolio Buddy 2. Verwenden Sie dies für jede Aufgabe, die React 19, TypeScript, Portfolioanalyse-Funktionen, Metrikberechnungen, Handelsstrategievergleiche oder die Arbeit mit der Portfolio Buddy 2-Codebasis umfasst. Enthält Tech-Stack, bekannte Probleme und Architekturbeschränkungen.

Was ist skillshub?

Diese Skill bietet einen vollständigen Projektkontext für die Entwicklung von Portfolio Buddy 2, einem Portfolio-Analyse-Tool für Investoren und Futures-Händler, das auf React 19, TypeScript, Vite, Tailwind CSS, shadcn/ui, Chart.js und Supabase basiert. Sie beschreibt detailliert den Tech-Stack, die Projektziele (wie Strategievergleiche, Korrelationsmatrizen, Risikokennzahlen und CSV-Uploads) sowie aktuelle bekannte Probleme und technische Schulden, z. B. ungenutzte Abhängigkeiten (Recharts), zu große Komponenten (PortfolioSection.tsx mit 591 Zeilen) und 15 TypeScript-Verstöße durch `any`-Typen. Die Skill erklärt die Architekturbeschränkungen (max. 200 Zeilen pro Komponente, reine React-Hooks, keine externen State-Management-Bibliotheken) und gibt eine detaillierte Übersicht über die Verzeichnisstruktur mit allen Komponenten, Hooks und Utilities. Sie ist nützlich für Entwickler, die an Portfolio Buddy 2 arbeiten, um schnell in den Kontext einzusteigen, bekannte Fehler zu berücksichtigen und Architekturrichtlinien einzuhalten.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Portfolio Buddy 2 - Projektkontext

Technologie-Stack

  • Frontend: React 19, TypeScript, Vite
  • UI: Tailwind CSS, shadcn/ui (nur Farbsystem)
  • Diagramme: Chart.js, react-chartjs-2, chartjs Plugins (Zoom, Annotation, Datumsadapter)
  • Zustandsverwaltung: Reines React (useState, useMemo, useCallback)
  • Daten-Hilfsfunktionen: date-fns für Datumsmanipulation
  • Backend: Supabase (PostgreSQL)
  • Bereitstellung: Cloudflare Pages

Projektzweck

Portfolio-Analyse-Tool für Investoren und Futures-Händler zum:

  • Vergleichen von Handelsstrategien mit Benchmark-Assets (SPY, GLD)
  • Berechnen von Korrelationsmatrizen zwischen Assets (Spearman & Pearson)
  • Analysieren von Risikokennzahlen und Performance (Sharpe, Sortino, Max DD, usw.)
  • Hochladen von Handelsdaten per CSV und Visualisieren der Ergebnisse
  • Anwenden von Kontraktmultiplikatoren zur Anpassung von Metriken für den Futures-Handel
  • Filtern von Daten nach Datumsbereich für zeitraumspezifische Analysen

Bekannte Probleme & Technische Schulden

Aktuelle technische Schulden

  1. Nicht verwendete Abhängigkeit: Recharts (11,5 KB) installiert, aber nie importiert

    • Sollte aus package.json entfernt werden
    • Verwendet stattdessen Chart.js
  2. Überdimensionierte Komponenten: Verstoßen gegen die 200-Zeilen-Norm

    • PortfolioSection.tsx (591 Zeilen) → muss in Unterkomponenten refaktorisiert werden
    • App.tsx (351 Zeilen) → Abschnitte in Komponenten auslagern
    • MetricsTable.tsx (242 Zeilen) → verbessert, aber immer noch über dem Limit
  3. TypeScript-Verstöße: 15 Instanzen des Typs any

    • usePortfolio.ts: 11 Vorkommen in Handels-/Metriktypen
    • useMetrics.ts: 4 Vorkommen in Sortiervergleichen
    • dataUtils.ts: 1 Vorkommen im Metrik-Interface

Bekannte Fehler

  1. Supabase-Upload-Fehler: Gelegentliche 500-Fehler bei großen Uploads
    • Verbesserte Fehlerbehandlung in Commit 9fb7fdb hinzugefügt
    • Fehlerbehandlung in Upload-Hooks überprüfen
    • Sicherstellen, dass Zeilenlimits im kostenlosen Tarif nicht überschritten werden

Kürzlich hinzugefügte Funktionen

  • Sortino-Ratio-Berechnung (Commits 258ba3a, 9f25040)
    • Ort: Inline in PortfolioSection.tsx implementiert (Zeilen 133-158)
    • Risikofreier Zinssatz-Input für benutzerdefinierten risikofreien Zinssatz
    • Annualisierte Abwärtsabweichung mit sqrt(365)-Faktor
    • Korrigierte Varianzberechnung (dividiert durch alle Renditen, nicht nur negative)
    • Im Portfolio-Statistikbereich angezeigt (Zeile 535)
    • Hinweis: NICHT in dataUtils.ts - aufgrund des Portfolio-Kontexts in der Komponente belassen
  • Datumsbereichsfilterung (Commit 258ba3a)
    • Portfolio-Daten nach Start-/Enddatum filtern
    • Im usePortfolio-Hook implementiert
  • Erweiterte Mehrspaltensortierung (useSorting-Hook)
    • Nach mehreren Spalten mit Priorität sortieren
    • Benutzerdefinierte Vergleichslogik pro Spalte

Architekturbeschränkungen

  • Komponentenlimit: Max. 200 Zeilen pro Komponente (derzeit von 3 Komponenten verletzt)
  • Hook-Muster: Benutzerdefinierte Hooks in /src/hooks/
  • Utils-Muster: Reine Funktionen in /src/utils/
  • Typsicherheit: Strenges TypeScript, keine any-Typen (15 Verstöße als technische Schulden vorhanden)
  • Zustandsverwaltung: Nur reine React-Hooks - kein Zustand oder TanStack Query

Wichtige Komponentenstruktur

src/
├── components/
│   ├── AnalyticsControls.tsx     (Umschalter für Metriken/Portfolio/Korrelationsansichten)
│   ├── ContractInput.tsx         (Kontraktmultiplikator-Eingaben)
│   ├── CorrelationHeatmap.tsx    (Korrelationsvisualisierung)
│   ├── CorrelationSection.tsx    (Wrapper für Korrelationsanalyse)
│   ├── CustomTooltip.tsx         (Diagramm-Tooltips)
│   ├── ErrorList.tsx             (Fehleranzeige)
│   ├── Header.tsx                (App-Kopfzeile)
│   ├── MasterContractControl.tsx (Kontraktwert auf alle anwenden)
│   ├── MetricsTable.tsx          (Metrikanzeige & Auswahl)
│   ├── PortfolioSection.tsx      (Portfolio-Diagramme & Analyse - 591 Zeilen!)
│   ├── SessionComplete.tsx       (Abschluss-UI)
│   ├── SortableHeader.tsx        (Tabellenkopf mit Sortierindikatoren)
│   ├── UploadedFilesList.tsx     (Liste hochgeladener Dateien)
│   └── UploadSection.tsx         (Datei-Upload nach Supabase)
├── hooks/
│   ├── useContractMultipliers.ts (Verwaltung von Kontraktmultiplikatoren)
│   ├── useMetrics.ts             (Berechnung von Handelsmetriken)
│   ├── usePortfolio.ts           (Portfoliodaten & Datumsfilterung)
│   └── useSorting.ts             (erweiterte Mehrspaltensortierung)
└── utils/
    └── dataUtils.ts              (Metrikberechnungen, CSV-Parsing, Korrelationen)

Migrationskontext

Migration von 40 Funktionen aus der alten App (35/40 abgeschlossen). Siehe migration-tracker-Skill für Details.

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

Verwandte Skills