Communitygithub.com

aiskillstore/marketplace

Contexto autocargado para el desarrollo de Portfolio Buddy 2. Úselo para cualquier tarea que involucre: desarrollo con React 19, TypeScript, funciones de análisis de cartera, cálculos de métricas, comparación de estrategias de trading o trabajo con el código base de Portfolio Buddy 2. Contiene el stack tecnológico, problemas conocidos y restricciones arquitectónicas.

¿Qué es marketplace?

Este skill proporciona un contexto de proyecto completo y autocargado para desarrolladores que trabajan en Portfolio Buddy 2, una herramienta de análisis de carteras diseñada para inversores y traders de futuros. Su principal utilidad radica en que elimina la necesidad de recordar y comunicar manualmente los detalles del proyecto a un asistente de IA, ya que inyecta automáticamente información crucial como el stack tecnológico (React 19, TypeScript, Vite, Chart.js, Supabase, Cloudflare Pages), problemas conocidos (deuda técnica como componentes de más de 200 líneas y 15 violaciones del tipo 'any'), y restricciones arquitectónicas (uso exclusivo de hooks de React, sin TanStack Query). Esto permite a los desarrolladores enfocarse en tareas de alto nivel como añadir nuevas funcionalidades de análisis o corregir bugs, confiando en que el contexto técnico ya está disponible para el agente. El skill está optimizado para plataformas como Claude Code, Cursor o Codex, y se activa automáticamente al iniciar cualquier tarea relacionada con el proyecto, facilitando la comprensión del estado actual del código, los patrones de diseño y las migraciones en curso.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Portfolio Buddy 2 - Contexto del Proyecto

Stack Tecnológico

  • Frontend: React 19, TypeScript, Vite
  • UI: Tailwind CSS, shadcn/ui (solo sistema de colores)
  • Gráficos: Chart.js, react-chartjs-2, plugins chartjs (zoom, anotación, adaptador de fechas)
  • Estado: React plano (useState, useMemo, useCallback)
  • Utilidades de datos: date-fns para manipulación de fechas
  • Backend: Supabase (PostgreSQL)
  • Despliegue: Cloudflare Pages

Propósito del Proyecto

Herramienta de análisis de carteras para inversores y traders de futuros para:

  • Comparar estrategias de trading vs activos de referencia (SPY, GLD)
  • Calcular matrices de correlación entre activos (Spearman y Pearson)
  • Analizar métricas de riesgo y rendimiento (Sharpe, Sortino, Max DD, etc.)
  • Subir datos de trading vía CSV y visualizar resultados
  • Aplicar multiplicadores de contrato para ajustar métricas en trading de futuros
  • Filtrar datos por rango de fechas para análisis por periodos específicos

Problemas Conocidos y Deuda Técnica

Deuda Técnica Actual

  1. Dependencia no utilizada: Recharts (11.5KB) instalado pero nunca importado

    • Debería eliminarse de package.json
    • Actualmente se usa Chart.js en su lugar
  2. Componentes Sobredimensionados: Violan el estándar de 200 líneas

    • PortfolioSection.tsx (591 líneas) → necesita refactorización en subcomponentes
    • App.tsx (351 líneas) → extraer secciones en componentes
    • MetricsTable.tsx (242 líneas) → mejorado pero aún supera el límite
  3. Violaciones de TypeScript: 15 instancias de tipo any

    • usePortfolio.ts: 11 ocurrencias en tipos de trade/métricas
    • useMetrics.ts: 4 ocurrencias en comparaciones de ordenamiento
    • dataUtils.ts: 1 ocurrencia en la interfaz Metrics

Errores Conocidos

  1. Errores de Subida a Supabase: Errores 500 intermitentes en subidas grandes
    • Manejo de errores mejorado añadido en el commit 9fb7fdb
    • Verificar el manejo de errores en los hooks de subida
    • Confirmar que no se excedan los límites de filas en el plan gratuito

Funcionalidades Recientes Añadidas

  • Cálculo del Ratio Sortino (commits 258ba3a, 9f25040)
    • Ubicación: Implementado en línea en PortfolioSection.tsx (líneas 133-158)
    • Estado de entrada de tasa libre de riesgo para tasa especificada por el usuario
    • Desviación a la baja anualizada usando el factor sqrt(365)
    • Cálculo de varianza corregido (divide por rendimientos totales, no solo negativos)
    • Mostrado en la sección de estadísticas de cartera (línea 535)
    • Nota: NO está en dataUtils.ts - se mantiene en el componente debido al contexto de nivel de cartera
  • Filtrado por Rango de Fechas (commit 258ba3a)
    • Filtrar datos de cartera por fecha de inicio/fin
    • Implementado en el hook usePortfolio
  • Ordenamiento Avanzado Multi-Columna (hook useSorting)
    • Ordenar por múltiples columnas con prioridad
    • Lógica de comparación personalizada por columna

Restricciones Arquitectónicas

  • Límite de Componentes: Máximo 200 líneas por componente (actualmente violado por 3 componentes)
  • Patrón de Hooks: Hooks personalizados en /src/hooks/
  • Patrón de Utilidades: Funciones puras en /src/utils/
  • Seguridad de Tipos: TypeScript estricto, sin tipos any (15 violaciones existen como deuda técnica)
  • Gestión de Estado: Solo hooks de React plano - sin Zustand ni TanStack Query

Estructura de Componentes Clave

src/
├── components/
│   ├── AnalyticsControls.tsx     (alternar vistas de Métricas/Cartera/Correlación)
│   ├── ContractInput.tsx         (entradas de multiplicador de contrato)
│   ├── CorrelationHeatmap.tsx    (visualización de correlación)
│   ├── CorrelationSection.tsx    (envoltorio de análisis de correlación)
│   ├── CustomTooltip.tsx         (tooltips de gráficos)
│   ├── ErrorList.tsx             (visualización de errores)
│   ├── Header.tsx                (encabezado de la aplicación)
│   ├── MasterContractControl.tsx (aplicar valor de contrato a todos)
│   ├── MetricsTable.tsx          (visualización y selección de métricas)
│   ├── PortfolioSection.tsx      (gráficos y análisis de cartera - ¡591 líneas!)
│   ├── SessionComplete.tsx       (UI de finalización)
│   ├── SortableHeader.tsx        (encabezado de tabla con indicadores de orden)
│   ├── UploadedFilesList.tsx     (lista de archivos subidos)
│   └── UploadSection.tsx         (subida de archivos a Supabase)
├── hooks/
│   ├── useContractMultipliers.ts (gestionar multiplicadores de contrato)
│   ├── useMetrics.ts             (calcular métricas de trading)
│   ├── usePortfolio.ts           (datos de cartera y filtrado por fecha)
│   └── useSorting.ts             (ordenamiento avanzado multi-columna)
└── utils/
    └── dataUtils.ts              (cálculos de métricas, análisis CSV, correlaciones)

Convenciones Clave

  • Alias de ruta: @/ mapea a src/ — usarlo para todas las importaciones internas
  • shadcn-ui: Solo tokens de color — variables CSS en src/index.css, sin componentes shadcn reales instalados. Se podrían añadir más tarde vía npx shadcn@latest add button, etc.
  • Flujo de trabajo Git: Ramas de funcionalidad → git checkout -b feature/nombre → commit convencional (feat:, fix:, chore:) → PR a main
  • Marca comunitaria: Comunidad de trading 5minfutures.com; logo de Skool en activos; formulario GoHighLevel embebido

Contexto de Migración

Migrando 40 funcionalidades desde la aplicación antigua (90% completado). Ver el skill migration-tracker para más detalles.

Individual skills in this repo

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

aiskillstore/marketplace

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.

aiskillstore/marketplace

Use when the user asks to "pre-launch check the landing page", "run a Quality-Score preflight", or "verify ad-to-page message match before launch"; produces an ad↔page continuity report — message-match gaps, above-the-fold check, page-speed read, form-friction count, mobile-render flags — as a pass/fix punch list. Not for redesigning or rewriting the page — use landing-optimizer; not for scoring the account or the RQS — use ad-account-auditor. 落地页体验预检/广告落地页一致性检查

aiskillstore/marketplace

Use when the user asks to "optimize our landing page for influencer traffic", "fix our promo-code landing page", or "improve conversion from a creator campaign"; produces a message-match audit, page-structure and social-proof recommendations, a promo-code/CTA conversion plan, and an A/B test roadmap. Not for measuring campaign results after launch — use performance-analyzer.

aiskillstore/marketplace

Audit a landing page, sales page or checkout page for conversion leaks and return a fix list ordered by expected revenue impact. Use when asked to review, critique or improve a landing page, sales page, opt-in page, product page or checkout flow, when conversion rate is low, when paid traffic is not converting, or when someone asks "why isn't this page converting" or wants a CRO / landing page review.

aiskillstore/marketplace

This skill helps users extract GitHub repository project details and contributor contact information using keywords, stars, and update dates. Agent should proactively apply this skill when users express needs like search for GitHub projects by keywords, find top open-source contributors in specific domains, extract developer contacts from GitHub repositories, discover trending repositories with high stars, gather contributor profiles and social links for tech recruiting, retrieve GitHub project descriptions and metrics, build developer communities by finding active contributors, search for repositories updated recently, collect personal website and Twitter links of developers, generate targeted leads for developer tools, or track active open-source contributors for collaboration.

aiskillstore/marketplace

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

aiskillstore/marketplace

Using the Wonda CLI to generate images, videos, music, and audio from the terminal — plus LinkedIn, Reddit, and X/Twitter research and automation

aiskillstore/marketplace

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

aiskillstore/marketplace

Generates creative domain name ideas for your project and checks availability across multiple TLDs (.com, .io, .dev, .ai, etc.). Saves hours of brainstorming and manual checking.

aiskillstore/marketplace

Process video files with audio extraction, format conversion (mp4, webm), and Whisper transcription. Use when user mentions video conversion, audio extraction, transcription, mp4, webm, ffmpeg, or whisper transcription.

aiskillstore/marketplace

Generate or edit raster images when the task benefits from AI-created bitmap visuals such as photos, illustrations, textures, sprites, mockups, or transparent-background cutouts. Use when Codex should create a brand-new image, transform an existing image, or derive visual variants from references, and the output should be a bitmap asset rather than repo-native code or vector. Do not use when the task is better handled by editing existing SVG/vector/code-native assets, extending an established icon or logo system, or building the visual directly in HTML/CSS/canvas.

aiskillstore/marketplace

A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).

aiskillstore/marketplace

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

aiskillstore/marketplace

Account assets, equity and fund positions, P&L, cash flow records, account statements, margin ratios, buy-power estimates, order management, and DCA recurring investments via Longbridge (most require Trade permission). Frameworks: portfolio diagnosis, rebalancing, asset allocation, risk analysis (VaR/CVaR), performance attribution, and tax-loss harvesting. Triggers: "持仓", "账户", "盈亏", "资产", "对账单", "下单", "买入", "卖出", "撤单", "定投", "组合诊断", "再平衡", "资产配置", "风险分析", "绩效归因", "税损收割", "持倉", "賬戶", "盈虧", "對賬單", "下單", "買入", "賣出", "組合診斷", "再平衡", "稅損收割", "positions", "portfolio", "P&L", "order", "buy", "sell", "DCA", "statement", "risk analysis", "rebalancing", "tax harvesting", "我的风险", "持仓风险", "风险敞口", "資產", "資產配置", "風險分析", "績效歸因", "撤單

aiskillstore/marketplace

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

aiskillstore/marketplace

Use for Codex models/pricing, scheduled tasks, skills, settings, setup, troubleshooting, customization, automations, and self-knowledge—including 'you,' 'your,' 'this app,' or 'this coding agent' when they refer to Codex—and for OpenAI APIs/products and ChatGPT Work. Also use for model choice/migration, prompting, SDKs, Responses, Realtime, agents, evals, and Chat/Work/Codex comparisons. Do not use for generic app/software tasks that merely mention Codex.

aiskillstore/marketplace

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

aiskillstore/marketplace

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

aiskillstore/marketplace

Perform a read-only, defect-first review of a specified code change and return every actionable finding. Use when another agent delegates review of uncommitted changes, a base-branch diff, a commit, or custom review instructions.

aiskillstore/marketplace

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, and portfolios that convert visitors into opportunities.

Skills relacionados