Communitygithub.com

tradeblocks-org/tradeblocks-skills

Análisis de cartera para estrategias de trading. Explora correlación, diversificación y características de rendimiento combinadas. Útil para entender cómo se relacionan las estrategias, explorar efectos de diversificación o analizar la composición de la cartera.

¿Qué es tradeblocks-skills?

Esta habilidad está diseñada para agentes de IA (como Claude Code, Cursor, Codex) que trabajan con TradeBlocks MCP server, proporcionando un conjunto completo de herramientas para analizar y optimizar carteras de estrategias de trading. Su utilidad principal es ayudar a los desarrolladores y usuarios a comprender las dinámicas complejas de la cartera, identificar riesgos de concentración, redundancias entre estrategias y oportunidades de mejora en la relación riesgo-rendimiento. La habilidad soporta análisis detallados como salud de la cartera, correlación entre pares, mapas de estructura (por régimen de volatilidad y dirección de tendencia), contribución marginal, alocación por régimen, similitud de estrategias y escalamiento hipotético. Funciona tomando datos de un bloque de estrategias (o múltiples) cargado en el servidor MCP, y utiliza parámetros configurables para ajustar los umbrales de análisis. Los resultados se presentan en informes con calificaciones, alertas y métricas clave (Sharpe, Sortino, drawdown, correlación promedio), lo que permite a los agentes tomar decisiones informadas sobre la composición de la cartera. Es especialmente valiosa para identificar superposiciones ocultas, dependencias de cola (riesgo en crisis) y desviaciones entre las tesis de las estrategias y su desempeño real.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tradeblocks-org/tradeblocks-skills/tree/HEAD/skills/portfolio

Preguntar en tu IA favorita

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

Documentación

Análisis de Cartera

Explora cómo se relacionan las estrategias y qué implica combinarlas para las características de la cartera.

¿Qué Hace Esta Habilidad

Proporciona datos para ayudar a comprender la dinámica de la cartera:

  • Chequeo de Salud: Evaluación integral de la cartera en una sola llamada
  • Correlación: ¿Cómo se mueven las estrategias entre sí?
  • Estructura: ¿Dónde tiene la cartera superposiciones o puntos ciegos?
  • Contribución Marginal: ¿Qué estrategias ayudan o perjudican los rendimientos ajustados al riesgo?
  • Similitud: ¿Hay estrategias redundantes?
  • Escalamiento Hipotético: ¿Cómo afectarían los cambios en las asignaciones a la cartera?

Prerrequisitos

  • Servidor MCP de TradeBlocks en ejecución
  • Múltiples bloques de estrategia o un bloque multi-estrategia cargado
  • Perfiles de estrategia recomendados para cobertura de régimen y análisis de estructura

Proceso

Paso 1: Chequeo de Salud de la Cartera

Comienza con portfolio_health_check para una evaluación integral en una sola llamada.

Parámetros clave:

  • blockId: Nombre de la carpeta del bloque
  • correlationThreshold: Marcar pares por encima de este valor (por defecto: 0.5)
  • tailDependenceThreshold: Marcar pares de cola por encima de este valor (por defecto: 0.5)
  • profitProbabilityThreshold: Advertencia de probabilidad de ganancia en MC (por defecto: 0.95)
  • wfeThreshold: Advertencia de eficiencia walk-forward (por defecto: -0.15)

La herramienta devuelve un informe en capas:

  • Veredicto: SALUDABLE / PREOCUPACIONES_MODERADAS / PREOCUPACIONES_SIGNIFICATIVAS
  • Calificaciones: A-F en 9 dimensiones:
DimensiónQué Mide
DiversificaciónCorrelación entre pares de estrategias
Riesgo de ColaRiesgo de co-movimiento extremo conjunto
RobustezEficiencia walk-forward (OOS vs IS)
ConsistenciaProbabilidad Monte Carlo de ganancia
Cobertura de RégimenRendimiento de la estrategia en regímenes VIX
Cobertura de DíasCobertura de días de trading a lo largo de la semana
Riesgo de ConcentraciónAsignación por estructura, subyacente, DTE
Riesgo de CorrelaciónSuperposición consciente del perfil (mismo subyacente + DTE + días)
Alineación de EscalamientoDesviación de P&L por contrato entre backtest y real
  • Alertas: Advertencias específicas con detalles (pares de alta correlación, pares de dependencia de cola, etc.)
  • Números clave: Sharpe, Sortino, drawdown máximo, correlación promedio, dependencia de cola promedio, estadísticas MC, WFE

Presenta el veredicto, señala cualquier calificación por debajo de B y muestra los detalles de advertencia específicos.

Paso 2: Análisis de Correlación

Usa get_correlation_matrix para datos detallados de correlación por pares.

Parámetros clave:

  • blockId: Nombre de la carpeta del bloque
  • method: "kendall" (robusto, basado en rangos, por defecto), "spearman" (rangos), "pearson" (lineal)
  • alignment: "shared" (solo días que ambas operaron) o "zero-pad" (rellenar faltantes con 0)
  • timePeriod: "daily", "weekly" o "monthly" agregación
  • normalization: "raw" (P&L absoluto), "margin" (P&L/margen), "notional" (P&L/ nocional)
  • minSamples: Períodos compartidos mínimos para cálculo válido (por defecto: 10)
  • highlightThreshold: Marcar pares por encima de este valor (por defecto: 0.7)

Interpretación de valores de correlación:

CorrelaciónQué Indica
< 0.2Muy baja – las estrategias se mueven de forma independiente
0.2 - 0.4Baja – movimiento mayormente independiente
0.4 - 0.6Moderada – algún comportamiento compartido
0.6 - 0.8Alta – movimiento compartido significativo
> 0.8Muy alta – las estrategias se comportan de manera similar

Consulta references/correlation.md para saber por qué la tau de Kendall suele ser más informativa que la de Pearson para rendimientos de trading.

Paso 3: Mapa de Estructura de la Cartera

Usa portfolio_structure_map para ver una matriz Vol_Régimen x Dirección_Tendencia en todas las estrategias perfiladas.

Parámetros clave:

  • blockId: Opcional – omítelo para agregar en todos los bloques
  • minTrades: Umbral de advertencia de datos escasos (por defecto: 10)

La herramienta devuelve:

  • Matriz de 18 celdas (6 Regímenes_Vol x 3 Direcciones_Tendencia) con estadísticas por estrategia
  • Detección de superposición: 2+ estrategias activas en la misma celda
  • Puntos ciegos: Celdas sin operaciones en todas las estrategias
  • Advertencias de datos escasos: Celdas con menos operaciones que el umbral

Esta es la herramienta clave para entender la construcción de la cartera: dónde tiene cobertura la cartera y dónde no.

Paso 4: Contribución Marginal

Usa marginal_contribution para ver cómo cada estrategia afecta los rendimientos ajustados al riesgo de la cartera.

Parámetros clave:

  • blockId: Nombre de la carpeta del bloque
  • targetStrategy: Calcular para una estrategia específica solamente (opcional)
  • topN: Número de principales contribuyentes a devolver (por defecto: 5)

La herramienta devuelve:

  • Sharpe y Sortino de la cartera base
  • Impacto marginal de Sharpe y Sortino por estrategia
  • Estrategias más beneficiosas y menos beneficiosas

Interpretación:

  • Sharpe marginal negativo: Eliminar esta estrategia REDUCIRÍA el Sharpe de la cartera – está contribuyendo positivamente
  • Sharpe marginal positivo: Eliminar esta estrategia AUMENTARÍA el Sharpe de la cartera – podría estar perjudicando los rendimientos ajustados al riesgo
  • Nota: la contribución marginal mide el impacto ajustado al riesgo, no el P&L absoluto. Una estrategia rentable puede perjudicar el Sharpe si añade volatilidad.

Paso 5: Asesor de Asignación por Régimen

Usa regime_allocation_advisor para cotejar los regímenes esperados de los perfiles de estrategia con el rendimiento real.

Parámetros clave:

  • blockId: Opcional – omítelo para agregar en todas las estrategias perfiladas
  • minTrades: Operaciones mínimas por celda de régimen para estadísticas fiables (por defecto: 5)

La herramienta devuelve por estrategia y por régimen:

  • Si el régimen era esperado (según el perfil) o inesperado
  • Tasa de aciertos, P&L, número de operaciones en ese régimen
  • Clasificaciones:
    • thesis_aligned: La estrategia se desempeña como se esperaba en sus regímenes objetivo
    • thesis_violation: La estrategia tiene bajo rendimiento en regímenes que debería manejar
    • hidden_edge: La estrategia se desempeña bien en regímenes no marcados como esperados

Señala cualquier violación de tesis (estrategias que fallan donde no deberían) y bordes ocultos (oportunidades que el perfil no captura).

Paso 6: Similitud de Estrategias

Usa strategy_similarity para detectar estrategias potencialmente redundantes.

Parámetros clave:

  • blockId: Nombre de la carpeta del bloque
  • correlationThreshold: Correlación mínima para marcar (por defecto: 0.7)
  • tailDependenceThreshold: Dependencia de cola mínima para marcar (por defecto: 0.5)
  • minSharedDays: Días de trading compartidos mínimos (por defecto: 30)
  • topN: Número de pares más similares (por defecto: 5)

La herramienta devuelve:

  • Pares de estrategias más similares clasificados por puntuación de similitud combinada
  • Correlación, dependencia de cola y superposición de días de trading para cada par
  • Alertas para estrategias que pueden estar añadiendo riesgo sin beneficio de diversificación

Si dos estrategias están altamente correlacionadas Y tienen alta dependencia de cola, probablemente caerán juntas – la "diversificación" entre ellas es ilusoria.

Paso 7: Escalamiento Hipotético

Usa what_if_scaling para explorar cambios en la asignación.

Parámetros clave:

  • blockId: Nombre de la carpeta del bloque
  • strategyWeights: Peso por estrategia, ej., {"5/7 17D": 0.5, "Pickle RIC": 1.5}. Los no especificados por defecto a 1.0. Peso 0 = excluir.
  • strategies: Modo multi-estrategia – array con fuente de bloque por estrategia y factor de escala
  • showUncapped: Mostrar también resultados sin el límite de maxContractsPerTrade

La herramienta devuelve:

  • Comparación antes/después de las métricas de la cartera
  • Desglose por estrategia con los nuevos pesos
  • Consciente del perfil: respeta los límites de maxContractsPerTrade de los perfiles
  • Alertas cuando se establece ignoreMarginReq

Escenarios comunes:

  • "¿Qué pasa si elimino esta estrategia?" → establece su peso a 0
  • "¿Qué pasa si duplico esta asignación?" → establece el peso a 2.0
  • "¿Qué pasa si reduzco a la mitad todo excepto mi mejor rendimiento?" → ajusta los pesos en consecuencia

Paso 8: Presentar Hallazgos

Sintetiza los datos:

Salud de la Cartera:

  • Veredicto: [SALUDABLE / PREOCUPACIONES_MODERADAS / PREOCUPACIONES_SIGNIFICATIVAS]
  • Dimensiones que necesitan atención: [cualquier calificación por debajo de B]
  • Alertas clave: [advertencias específicas]

Hallazgos de Correlación:

  • Correlación promedio entre pares: [valor]
  • Par de mayor correlación: [par] en [valor]
  • Par de menor correlación: [par] en [valor]

Estructura:

  • Puntos ciegos de régimen: [celdas sin cobertura]
  • Áreas de superposición: [celdas con 2+ estrategias]
  • Concentración: [por subyacente, DTE, tipo de estructura]

Contribución Marginal:

  • Más beneficioso: [estrategia] (Sharpe marginal: [valor])
  • Menos beneficioso: [estrategia] (Sharpe marginal: [valor])

Lo que destaca:

  • [Patrones notables]
  • [Cualquier par de estrategias redundante]
  • [Violaciones de tesis o bordes ocultos]

Presenta estos como perspectivas basadas en datos históricos. El usuario puede decidir qué se ajusta a su tolerancia al riesgo y objetivos de cartera.

Referencias de Interpretación

Habilidades Relacionadas

Después del análisis de cartera:

  • /tradeblocks:compare – Comparación profunda de pares de estrategias o bloques específicos
  • /tradeblocks:risk – Análisis de tamaño de posición y Kelly
  • /tradeblocks:health-check – Métricas completas de cualquier estrategia individual

Notas

  • La correlación se mide sobre rendimientos agregados, no operación por operación
  • Los patrones de correlación pasados pueden no persistir en condiciones de mercado futuras
  • La correlación de cola (comportamiento en crisis) suele ser mayor que la correlación normal
  • Una baja correlación no garantiza protección – ambas pueden perder por diferentes razones
  • El tamaño de la muestra importa – 10 puntos de datos compartidos es el mínimo, más es mejor
  • Se requieren perfiles de estrategia para el análisis de cobertura de régimen, mapa de estructura y alineación de escalamiento

Skills relacionados