Communitygithub.com

aiskillstore/marketplace

Contexto carregado automaticamente para o desenvolvimento do Portfolio Buddy 2. Use para qualquer tarefa envolvendo: desenvolvimento React 19, TypeScript, análise de portfólio, cálculo de métricas, comparação de estratégias de trading ou trabalho com o código do Portfolio Buddy 2. Contém stack tecnológica, problemas conhecidos e restrições arquiteturais.

O que é marketplace?

O skill aiskillstore/marketplace fornece contexto completo de projeto para o Portfolio Buddy 2, uma ferramenta de análise de portfólio para investidores e traders de futuros. Ele documenta a stack tecnológica (React 19, TypeScript, Vite, Tailwind CSS, Chart.js, Supabase, Cloudflare Pages), o propósito do projeto (comparar estratégias de trading, calcular matrizes de correlação, analisar métricas de risco como Sharpe e Sortino, e visualizar dados de upload CSV), além de problemas conhecidos e dívida técnica (componentes acima do limite de 200 linhas, 15 violações de tipo `any`, e dependência não utilizada Recharts). O skill suporta o desenvolvimento ao listar bugs conhecidos (erros intermitentes 500 no upload para o Supabase), recursos recentes (cálculo do Índice Sortino, filtro por intervalo de datas, ordenação multi-coluna), e restrições arquiteturais (limite de 200 linhas por componente, uso de hooks React puros, TypeScript estrito). Ele é útil para desenvolvedores que trabalham no código do Portfolio Buddy 2, pois fornece as diretrizes, estrutura de diretórios e convenções de código necessárias para contribuir de forma consistente. O skill também menciona o contexto de migração de 40 funcionalidades de um aplicativo antigo (90% concluída).

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Portfolio Buddy 2 - Contexto do Projeto

Stack Tecnológica

  • Frontend: React 19, TypeScript, Vite
  • UI: Tailwind CSS, shadcn/ui (apenas sistema de cores)
  • Gráficos: Chart.js, react-chartjs-2, plugins chartjs (zoom, annotation, date adapter)
  • Estado: React puro (useState, useMemo, useCallback)
  • Utilitários de dados: date-fns para manipulação de datas
  • Backend: Supabase (PostgreSQL)
  • Deploy: Cloudflare Pages

Propósito do Projeto

Ferramenta de análise de portfólio para investidores e traders de futuros para:

  • Comparar estratégias de trading versus ativos de referência (SPY, GLD)
  • Calcular matrizes de correlação entre ativos (Spearman e Pearson)
  • Analisar métricas de risco e desempenho (Sharpe, Sortino, Max DD, etc.)
  • Fazer upload de dados de trading via CSV e visualizar resultados
  • Aplicar multiplicadores de contrato para ajustar métricas para trading de futuros
  • Filtrar dados por intervalo de datas para análise específica de período

Problemas Conhecidos e Dívida Técnica

Dívida Técnica Atual

  1. Dependência Não Utilizada: Recharts (11,5KB) instalada mas nunca importada

    • Deve ser removida do package.json
    • Atualmente usando Chart.js
  2. Componentes Acima do Tamanho: Violam o padrão de 200 linhas

    • PortfolioSection.tsx (591 linhas) → precisa ser refatorado em subcomponentes
    • App.tsx (351 linhas) → extrair seções em componentes
    • MetricsTable.tsx (242 linhas) → melhorado, mas ainda acima do limite
  3. Violações de TypeScript: 15 instâncias do tipo any

    • usePortfolio.ts: 11 ocorrências em tipos de trade/métricas
    • useMetrics.ts: 4 ocorrências em comparações de ordenação
    • dataUtils.ts: 1 ocorrência na interface Metrics

Bugs Conhecidos

  1. Erros de Upload no Supabase: Erros 500 intermitentes em uploads grandes
    • Tratamento de erros aprimorado adicionado no commit 9fb7fdb
    • Verificar o tratamento de erros nos hooks de upload
    • Verificar se os limites de linhas não foram excedidos no plano gratuito

Recursos Recentes Adicionados

  • Cálculo do Índice Sortino (commits 258ba3a, 9f25040)
    • Localização: Implementado inline em PortfolioSection.tsx (linhas 133-158)
    • Estado de taxa livre de risco para taxa livre de risco especificada pelo usuário
    • Desvio negativo anualizado usando fator sqrt(365)
    • Cálculo de variância corrigido (divide pelo total de retornos, não apenas negativos)
    • Exibido na seção de estatísticas do portfólio (linha 535)
    • Nota: NÃO está em dataUtils.ts - mantido no componente devido ao contexto de nível de portfólio
  • Filtro por Intervalo de Datas (commit 258ba3a)
    • Filtrar dados do portfólio por data de início/fim
    • Implementado no hook usePortfolio
  • Ordenação Avançada Multi-Coluna (hook useSorting)
    • Ordenar por múltiplas colunas com prioridade
    • Lógica de comparação personalizada por coluna

Restrições Arquiteturais

  • Limite de Componentes: Máximo de 200 linhas por componente (atualmente violado por 3 componentes)
  • Padrão de Hooks: Hooks personalizados em /src/hooks/
  • Padrão de Utilitários: Funções puras em /src/utils/
  • Segurança de Tipos: TypeScript estrito, sem tipos any (15 violações existem como dívida técnica)
  • Gerenciamento de Estado: Apenas hooks React puros - sem Zustand ou TanStack Query

Estrutura de Componentes Principais

src/
├── components/
│   ├── AnalyticsControls.tsx     (alternar visualizações Métricas/Portfólio/Correlação)
│   ├── ContractInput.tsx         (entradas de multiplicador de contrato)
│   ├── CorrelationHeatmap.tsx    (visualização de correlação)
│   ├── CorrelationSection.tsx    (wrapper de análise de correlação)
│   ├── CustomTooltip.tsx         (tooltips de gráficos)
│   ├── ErrorList.tsx             (exibição de erros)
│   ├── Header.tsx                (cabeçalho do aplicativo)
│   ├── MasterContractControl.tsx (aplicar valor de contrato a todos)
│   ├── MetricsTable.tsx          (exibição e seleção de métricas)
│   ├── PortfolioSection.tsx      (gráficos e análise do portfólio - 591 linhas!)
│   ├── SessionComplete.tsx       (UI de conclusão)
│   ├── SortableHeader.tsx        (cabeçalho de tabela com indicadores de ordenação)
│   ├── UploadedFilesList.tsx     (lista de arquivos enviados)
│   └── UploadSection.tsx         (upload de arquivos para o Supabase)
├── hooks/
│   ├── useContractMultipliers.ts (gerenciar multiplicadores de contrato)
│   ├── useMetrics.ts             (calcular métricas de trading)
│   ├── usePortfolio.ts           (dados do portfólio e filtragem por data)
│   └── useSorting.ts             (ordenação avançada multi-coluna)
└── utils/
    └── dataUtils.ts              (cálculos de métricas, parsing de CSV, correlações)

Convenções Principais

  • Alias de caminho: @/ mapeia para src/ — use-o para todas as importações internas
  • shadcn-ui: Apenas tokens de cor — variáveis CSS em src/index.css, nenhum componente shadcn real instalado. Podem ser adicionados posteriormente via npx shadcn@latest add button, etc.
  • Fluxo de trabalho Git: Branches de funcionalidade → git checkout -b feature/nome → commit convencional (feat:, fix:, chore:) → PR para main
  • Marca da comunidade: Comunidade de trading 5minfutures.com; logotipo Skool nos assets; formulário GoHighLevel incorporado

Contexto de Migração

Migrando 40 funcionalidades do aplicativo antigo (90% concluída). Consulte o skill migration-tracker para detalhes.

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.

Habilidades Relacionadas