Communitygithub.com

leecino1/boutique-skills

Análisis integral de carteras de inversión mediante la integración con el servidor MCP de Alpaca para obtener tenencias y posiciones, y luego analizar la asignación de activos, métricas de riesgo, posiciones individuales, diversificación y generar recomendaciones de reequilibrio. Úsalo cuando el usuario solicite una revisión de cartera, análisis de posiciones, evaluación de riesgos, revisión de rendimiento o sugerencias de reequilibrio para su cuenta de corretaje.

¿Qué es boutique-skills?

Portfolio Manager es una herramienta de análisis y gestión de carteras de inversión que se integra con el servidor MCP de Alpaca para obtener datos en tiempo real de las tenencias y posiciones de una cuenta de corretaje. A partir de estos datos, realiza un análisis completo que incluye la asignación de activos, la diversificación, métricas de riesgo, evaluación de posiciones individuales y recomendaciones de reequilibrio. Es útil para inversores que necesitan una revisión detallada de su cartera, identificación de riesgos de concentración, evaluación del rendimiento y sugerencias accionables para optimizar su estrategia de inversión. El flujo de trabajo consta de seis pasos: obtención de datos de Alpaca, enriquecimiento de datos de mercado, análisis a nivel de cartera (asignación, diversificación, riesgo y rendimiento), análisis detallado de posiciones individuales con recomendaciones de acción, generación de recomendaciones de reequilibrio priorizadas y creación de un informe completo en formato Markdown. La herramienta se basa en marcos de referencia incluidos en el repositorio para cada dimensión del análisis.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/leecyno1/boutique-skills/tree/HEAD/skills/default/portfolio-manager

Preguntar en tu IA favorita

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

Documentación

Gestor de Cartera

Resumen

Analiza y gestiona carteras de inversión integrándose con el servidor MCP de Alpaca para obtener datos de tenencias en tiempo real, realizando luego un análisis completo que cubre la asignación de activos, la diversificación, las métricas de riesgo, la evaluación de posiciones individuales y las recomendaciones de reequilibrio. Genera informes detallados de cartera con información procesable.

Esta habilidad aprovecha la API de corretaje de Alpaca a través de MCP (Protocolo de Contexto de Modelo) para acceder a datos de cartera en vivo, lo que garantiza que el análisis se base en posiciones reales actuales en lugar de datos ingresados manualmente.

Cuándo Usarlo

Invoca esta habilidad cuando el usuario solicite:

  • "Analiza mi cartera"
  • "Revisa mis posiciones actuales"
  • "¿Cuál es mi asignación de activos?"
  • "Revisa el riesgo de mi cartera"
  • "¿Debería reequilibrar mi cartera?"
  • "Evalúa mis tenencias"
  • "Revisión del rendimiento de la cartera"
  • "¿Qué acciones debería comprar o vender?"
  • Cualquier solicitud que implique análisis o gestión a nivel de cartera

Requisitos Previos

Configuración del Servidor MCP de Alpaca

Esta habilidad requiere que el servidor MCP de Alpaca esté configurado y conectado. El servidor MCP proporciona acceso a:

  • Posiciones actuales de la cartera
  • Patrimonio de la cuenta y poder de compra
  • Posiciones y transacciones históricas
  • Datos de mercado para valores mantenidos

Herramientas del Servidor MCP Utilizadas:

  • get_account_info - Obtener patrimonio de la cuenta, poder de compra, saldo de efectivo
  • get_positions - Recuperar todas las posiciones actuales con cantidades, base de costo, valor de mercado
  • get_portfolio_history - Datos de rendimiento histórico de la cartera
  • Herramientas de datos de mercado para cotizaciones de precios y fundamentales

Si el servidor MCP de Alpaca no está conectado, informa al usuario y proporciona instrucciones de configuración desde references/alpaca_mcp_setup.md.

Flujo de Trabajo

Paso 1: Obtener Datos de la Cartera a través de Alpaca MCP

Usa las herramientas del servidor MCP de Alpaca para recopilar información actual de la cartera:

1.1 Obtener Información de la Cuenta:

Usa mcp__alpaca__get_account_info para obtener:
- Patrimonio de la cuenta (valor total de la cartera)
- Saldo de efectivo
- Poder de compra
- Estado de la cuenta

1.2 Obtener Posiciones Actuales:

Usa mcp__alpaca__get_positions para obtener todas las tenencias:
- Símbolo del ticker
- Cantidad mantenida
- Precio de entrada promedio (base de costo)
- Precio de mercado actual
- Valor de mercado actual
- G/P no realizado ($ y %)
- Tamaño de la posición como % de la cartera

1.3 Obtener Historial de la Cartera (Opcional):

Usa mcp__alpaca__get_portfolio_history para análisis de rendimiento:
- Valores de patrimonio histórico
- Cálculo de rendimiento ponderado en el tiempo
- Análisis de drawdown

Validación de Datos:

  • Verifica que todas las posiciones tengan símbolos de ticker válidos
  • Confirma que los valores de mercado sumen aproximadamente el patrimonio de la cuenta
  • Revisa si hay posiciones obsoletas o inactivas
  • Maneja casos extremos (acciones fraccionarias, opciones, cripto si es compatible)

Paso 2: Enriquecer Datos de Posición

Para cada posición en la cartera, recopila datos de mercado adicionales y fundamentales:

2.1 Datos de Mercado Actuales:

  • Cotizaciones de precios en tiempo real o diferidos
  • Volumen diario y métricas de liquidez
  • Rango de 52 semanas
  • Capitalización de mercado

2.2 Datos Fundamentales: Usa WebSearch o las API de datos de mercado disponibles para obtener:

  • Clasificación de sector e industria
  • Métricas de valoración clave (P/E, P/B, rendimiento de dividendos)
  • Ganancias recientes e indicadores de salud financiera
  • Calificaciones de analistas y precios objetivo
  • Noticias recientes y desarrollos relevantes

2.3 Análisis Técnico:

  • Tendencia de precio (medias móviles de 20, 50 y 200 días)
  • Fuerza relativa
  • Niveles de soporte y resistencia
  • Indicadores de momento (RSI, MACD si están disponibles)

Paso 3: Análisis a Nivel de Cartera

Realiza un análisis completo de la cartera utilizando los marcos de referencia de los archivos:

3.1 Análisis de Asignación de Activos

Lee references/asset-allocation.md para marcos de asignación

Analiza la asignación actual en múltiples dimensiones:

Por Clase de Activo:

  • Acciones vs Renta Fija vs Efectivo vs Alternativos
  • Compara con la asignación objetivo para el perfil de riesgo del usuario
  • Evalúa si la asignación coincide con los objetivos de inversión

Por Sector:

  • Tecnología, Salud, Financiero, Consumo, etc.
  • Identifica riesgos de concentración sectorial
  • Compara con los pesos sectoriales de referencia (por ejemplo, S&P 500)

Por Capitalización de Mercado:

  • Distribución de gran capitalización vs mediana capitalización vs pequeña capitalización
  • Concentración en mega-capitalizaciones
  • Puntuación de diversificación por capitalización de mercado

Por Geografía:

  • EE. UU. vs Internacional vs Mercados Emergentes
  • Evaluación del riesgo de concentración nacional

Formato de Salida:

## Asignación de Activos

### Asignación Actual vs Objetivo
| Clase de Activo | Actual | Objetivo | Variación |
|-----------------|--------|----------|-----------|
| Acciones EE. UU. | XX.X% | YY.Y% | +/- Z.Z% |
| ... |

### Desglose Sectorial
[Descripción de gráfico circular o tabla con porcentajes sectoriales]

### Las 10 Principales Tenencias
| Rango | Símbolo | % de la Cartera | Sector |
|-------|---------|-----------------|--------|
| 1 | AAPL | X.X% | Tecnología |
| ... |

3.2 Análisis de Diversificación

Lee references/diversification-principles.md para teoría de diversificación

Evalúa la calidad de la diversificación de la cartera:

Concentración de Posiciones:

  • Identifica las principales tenencias y su peso agregado
  • Señala si alguna posición individual supera el 10-15% de la cartera
  • Calcula el Índice Herfindahl-Hirschman (HHI) para medir la concentración

Concentración Sectorial:

  • Identifica sectores dominantes
  • Señala si algún sector supera el 30-40% de la cartera
  • Compara con la diversidad sectorial de referencia

Análisis de Correlación:

  • Estima la correlación entre las posiciones principales
  • Identifica tenencias altamente correlacionadas (posible redundancia)
  • Evalúa el beneficio real de la diversificación

Número de Posiciones:

  • Rango óptimo: 15-30 acciones para carteras individuales
  • Señala si está sub-diversificada (<10 acciones) o sobre-diversificada (>50 acciones)

Salida:

## Evaluación de Diversificación

**Riesgo de Concentración:** [Bajo / Medio / Alto]
- Las 5 principales tenencias representan el XX% de la cartera
- Posición individual más grande: [SÍMBOLO] en XX%

**Diversificación Sectorial:** [Excelente / Buena / Aceptable / Pobre]
- Sector dominante: [Nombre del Sector] en XX%
- [Evaluación del equilibrio entre sectores]

**Número de Posiciones:** [Óptimo / Sub-diversificado / Sobre-diversificado]
- Total de posiciones: XX acciones
- [Recomendación]

**Preocupaciones de Correlación:**
- [Enumera cualquier par de posiciones altamente correlacionadas]
- [Sugerencias de mejora de la diversificación]

3.3 Análisis de Riesgo

Lee references/portfolio-risk-metrics.md para marcos de medición de riesgo

Calcula e interpreta métricas de riesgo clave:

Medidas de Volatilidad:

  • Beta estimada de la cartera (promedio ponderado de las betas de las posiciones)
  • Volatilidades de posiciones individuales
  • Desviación estándar de la cartera (si hay datos históricos disponibles)

Riesgo a la Baja:

  • Drawdown máximo (del historial de la cartera)
  • Drawdown actual desde el máximo
  • Posiciones con pérdidas no realizadas significativas

Concentración de Riesgo:

  • Porcentaje en acciones de alta volatilidad (beta > 1.5)
  • Porcentaje en empresas especulativas/no rentables
  • Uso de apalancamiento (si corresponde)

Riesgo de Cola:

  • Exposición a posibles eventos de cisne negro
  • Riesgo de concentración en una sola acción
  • Riesgo de evento sectorial específico

Salida:

## Evaluación de Riesgo

**Perfil de Riesgo General:** [Conservador / Moderado / Agresivo]

**Beta de la Cartera:** X.XX (frente al mercado en 1.00)
- Interpretación: La cartera es [más/menos] volátil que el mercado

**Drawdown Máximo:** -XX.X% (de $XXX,XXX a $XXX,XXX)
- Drawdown actual desde el máximo: -XX.X%

**Posiciones de Alto Riesgo:**
| Símbolo | % de la Cartera | Beta | Factor de Riesgo |
|---------|-----------------|------|------------------|
| [TICKER] | XX% | X.XX | [Alta volatilidad / Pérdida reciente / etc] |

**Concentraciones de Riesgo:**
- XX% en un solo sector ([Sector])
- XX% en acciones con beta > 1.5
- [Otros riesgos de concentración]

**Puntuación de Riesgo:** XX/100 (Riesgo [Bajo/Medio/Alto])

3.4 Análisis de Rendimiento

Evalúa el rendimiento de la cartera utilizando los datos disponibles:

Rendimientos Absolutos:

  • G/P no realizado general de la cartera ($ y %)
  • Posiciones con mejor rendimiento (top 5 por % de ganancia)
  • Posiciones con peor rendimiento (bottom 5 por % de pérdida)

Rendimientos Ponderados en el Tiempo (si hay historial disponible):

  • Rendimiento acumulado en el año
  • Rendimientos anualizados a 1, 3 y 5 años
  • Compara con el índice de referencia (S&P 500, índice relevante)

Rendimiento a Nivel de Posición:

  • Ratio de ganadores vs perdedores
  • Ganancia promedio en posiciones ganadoras
  • Pérdida promedio en posiciones perdedoras
  • Posiciones cerca de máximos/mínimos de 52 semanas

Salida:

## Revisión de Rendimiento

**Valor Total de la Cartera:** $XXX,XXX
**G/P No Realizado Total:** $XX,XXX (+XX.X%)
**Saldo de Efectivo:** $XX,XXX (XX% de la cartera)

**Mejores Rendimientos:**
| Símbolo | Ganancia | Valor de la Posición |
|---------|----------|----------------------|
| [TICKER] | +XX.X% | $XX,XXX |
| ... |

**Peores Rendimientos:**
| Símbolo | Pérdida | Valor de la Posición |
|---------|---------|----------------------|
| [TICKER] | -XX.X% | $XX,XXX |
| ... |

**Rendimiento vs Índice de Referencia (si está disponible):**
- Rendimiento de la cartera: +X.X%
- Rendimiento del S&P 500: +Y.Y%
- Alfa: +/- Z.Z%

Paso 4: Análisis de Posiciones Individuales

Para las posiciones clave (las 10-15 principales por peso en la cartera), realiza un análisis detallado:

Lee references/position-evaluation.md para el marco de análisis de posiciones

Para cada posición significativa:

4.1 Validación de la Tesis Actual:

  • ¿Por qué se inició esta posición? (si se conoce del contexto del usuario)
  • ¿La tesis de inversión se ha cumplido o se ha roto?
  • Desarrollos recientes de la empresa y noticias

4.2 Evaluación de Valoración:

  • Métricas de valoración actuales (P/E, P/B, etc.)
  • Compara con el rango de valoración histórico
  • Compara con pares del sector
  • Evaluación de Sobrevalorado / Justo / Infravalorado

4.3 Salud Técnica:

  • Tendencia del precio (alcista, bajista, lateral)
  • Posición relativa a las medias móviles
  • Niveles de soporte y resistencia
  • Estado del momento

4.4 Tamaño de la Posición:

  • Peso actual en la cartera
  • ¿El tamaño es apropiado dado el nivel de convicción y riesgo?
  • Sobreponderado o infraponderado vs óptimo

4.5 Recomendación de Acción:

  • MANTENER - La posición tiene un tamaño adecuado y la tesis está intacta
  • AUMENTAR - Infraponderado dada la oportunidad, la tesis se fortalece
  • REDUCIR - Sobreponderado o valoración estirada
  • VENDER - Tesis rota, mejores oportunidades en otro lugar

Salida por posición:

### [SÍMBOLO] - [Nombre de la Empresa] (XX.X% de la cartera)

**Detalles de la Posición:**
- Acciones: XXX
- Costo Promedio: $XX.XX
- Precio Actual: $XX.XX
- Valor de Mercado: $XX,XXX
- G/P No Realizado: $X,XXX (+XX.X%)

**Resumen Fundamental:**
- Sector: [Sector]
- Capitalización de Mercado: $XX.XB
- P/E: XX.X | Rendimiento de Dividendos: X.X%
- Desarrollos recientes: [Noticias clave o ganancias]

**Estado Técnico:**
- Tendencia: [Alcista / Bajista / Lateral]
- Precio vs MA de 50 días: [Por encima/Por debajo en XX%]
- Soporte: $XX.XX | Resistencia: $XX.XX

**Evaluación de la Posición:**
- **Estado de la Tesis:** [Intacta / Debilitándose / Rota / Fortaleciéndose]
- **Valoración:** [Infravalorada / Justa / Sobrevalorada]
- **Tamaño de la Posición:** [Óptimo / Sobreponderado / Infraponderado]

**Recomendación:** [MANTENER / AUMENTAR / REDUCIR / VENDER]
**Fundamento:** [Explicación de 1-2 oraciones]

Paso 5: Recomendaciones de Reequilibrio

Lee references/rebalancing-strategies.md para enfoques de reequilibrio

Genera recomendaciones de reequilibrio específicas:

5.1 Identificar Desencadenantes de Reequilibrio:

  • Posiciones que se han desviado significativamente de los pesos objetivo
  • Asignaciones sectoriales/clases de activos que requieren ajuste
  • Posiciones sobreponderadas para reducir (superaron el umbral)
  • Áreas infraponderadas para agregar (por debajo del umbral)
  • Consideraciones fiscales (implicaciones de ganancias de capital)

5.2 Desarrollar un Plan de Reequilibrio:

Posiciones a REDUCIR:

  • Posiciones sobreponderadas (>desviación del umbral del objetivo)
  • Acciones que han subido significativamente (preocupaciones de valoración)
  • Posiciones concentradas que superan el 15-20% de la cartera
  • Posiciones con tesis rota

Posiciones a AUMENTAR:

  • Sectores o clases de activos infraponderados
  • Posiciones de alta convicción actualmente infraponderadas
  • Nuevas oportunidades para mejorar la diversificación

Despliegue de Efectivo:

  • Si hay exceso de efectivo (>10% de la cartera), sugiere su despliegue
  • Prioriza según la oportunidad y las brechas de asignación

5.3 Priorización: Clasifica las acciones de reequilibrio por prioridad:

  1. Inmediata - Reducción de riesgo (recortar posiciones concentradas)
  2. Alta Prioridad - Desviación importante de la asignación (>10% del objetivo)
  3. Prioridad Media - Desviación moderada (5-10% del objetivo)
  4. Baja Prioridad - Ajustes finos y oportunistas

Salida:

## Recomendaciones de Reequilibrio

### Resumen
- **Reequilibrio Necesario:** [Sí / No / Opcional]
- **Razón Principal:** [Riesgo de concentración / Desviación sectorial / Despliegue de efectivo / etc]
- **Operaciones Estimadas:** X órdenes de venta, Y órdenes de compra

### Acciones Recomendadas

#### ALTA PRIORIDAD: Reducción de Riesgo
**REDUCIR [SÍMBOLO]** de XX% a YY% de la cartera
- **Acciones a Vender:** XX acciones (~$XX,XXX)
- **Fundamento:** [Sobreponderado / Valoración extendida / etc]
- **Impacto Fiscal:** $X,XXX de ganancia de capital (est)

#### PRIORIDAD MEDIA: Asignación de Activos
**AUMENTAR exposición a [Sector/Clase de Activo]**
- **Objetivo:** Aumentar de XX% a YY%
- **Acciones Sugeridas:** [SÍMBOLO1, SÍMBOLO2, SÍMBOLO3]
- **Cantidad a Invertir:** ~$XX,XXX

#### DESPLIEGUE DE EFECTIVO
**Efectivo Actual:** $XX,XXX (XX% de la cartera)
- **Recomendación:** [Desplegar / Mantener para oportunidades / Reducir a X%]
- **Asignación Sugerida:** [Distribución entre sectores/acciones]

### Plan de Implementación
1. [Primera acción - prioridad más alta]
2. [Segunda acción]
3. [Tercera acción]
...

**Consideraciones de Momento:**
- [Planificación de fin de año fiscal / Temporada de ganancias / Condiciones del mercado]
- [Fase sugerida si corresponde]

Paso 6: Generar Informe de Cartera

Crea un informe completo en markdown guardado en la raíz del repositorio:

Nombre de Archivo: portfolio_analysis_YYYY-MM-DD.md

Estructura del Informe:

# Informe de Análisis de Cartera

**Cuenta:** [Tipo de cuenta si está disponible]
**Fecha del Informe:** AAAA-MM-DD
**Valor de la Cartera:** $XXX,XXX
**G/P Total:** $XX,XXX (+XX.X%)

---

## Resumen Ejecutivo

[3-5 viñetas resumiendo hallazgos clave]
- Evaluación general de la salud de la cartera
- Principales fortalezas
- Riesgos o preocupaciones clave
- Recomendaciones principales

---

## Resumen de Tenencias

[Tabla resumen de todas las posiciones]

---

## Asignación de Activos
[Sección del Paso 3.1]

---

## Análisis de Diversificación
[Sección del Paso 3.2]

---

## Evaluación de Riesgo
[Sección del Paso 3.3]

---

## Revisión de Rendimiento
[Sección del Paso 3.4]

---

## Análisis de Posiciones
[Análisis del Paso 4 para las principales 10-15 posiciones]

---

## Recomendaciones de Reequilibrio
[Sección del Paso 5]

---

## Apéndice
- Metodología
- Fuentes de datos
- Supuestos
- Limitaciones

Paso 7: Archivos de Referencia

Esta habilidad utiliza los siguientes archivos de referencia en el repositorio:

  1. references/asset-allocation.md - Marcos de asignación de activos objetivo para diferentes perfiles de riesgo
  2. references/diversification-principles.md - Teoría y principios de diversificación de cartera
  3. references/portfolio-risk-metrics.md - Métodos de medición de riesgo y benchmarks
  4. references/position-evaluation.md - Marco de análisis de posiciones individuales
  5. references/rebalancing-strategies.md - Enfoques y umbrales de reequilibrio
  6. references/alpaca_mcp_setup.md - Configuración del servidor MCP de Alpaca

Individual skills in this repo

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

leecyno1/boutique-skills

Review fixed income portfolios by pricing multiple bonds, retrieving reference data, analyzing cashflows, and running scenario analysis. Use when reviewing bond portfolios, computing portfolio duration and DV01, analyzing cashflow waterfalls, stress testing rate scenarios, or assessing portfolio composition.

leecyno1/boutique-skills

Track and analyze portfolio company performance against plan. Ingests monthly/quarterly financial packages (Excel, PDF), extracts KPIs, flags variances to budget, and produces summary dashboards. Use when reviewing portfolio company financials, preparing board materials, or monitoring covenant compliance. Triggers on "review portfolio company", "monthly financials", "how is [company] performing", "covenant check", or "portfolio update".

leecyno1/boutique-skills

Analyze portfolio allocation drift and generate rebalancing trade recommendations across accounts. Considers tax implications, transaction costs, and wash sale rules. Triggers on "rebalance", "portfolio drift", "allocation check", "rebalancing trades", or "my portfolio is out of balance".

leecyno1/boutique-skills

Router skill for LLMQuant portfolio-lab workflows. Use when the user needs portfolio exposure maps, what-if simulations, scenario states, or virtual portfolio comparisons.

leecyno1/boutique-skills

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

leecyno1/boutique-skills

Best practices for Remotion - Video creation in React

leecyno1/boutique-skills

Agent skill at skills/default/video-autopilot-kit/SKILL.md

Skills relacionados