Communitygithub.com

JuanOrtizOvied/construir-portafolio

Acompaña paso a paso a una persona a armar su portafolio de inversión a partir de sus estados de cuenta, capturas, PDFs y factsheets, clasifica cada producto en las categorías y subcategorías de la plantilla y entrega un dashboard con el Excel descargable.

¿Qué es construir-portafolio?

Esta skill guía al usuario a través de un proceso iterativo para construir un portafolio de inversión completo. Al recibir documentos como estados de cuenta, PDFs o factsheets, la skill extrae automáticamente cada posición con su valor de mercado, moneda e institución, y las clasifica en las categorías y subcategorías definidas (Inversiones Directas, Mercados Privados, Club Deals, Mercados Públicos, Otros, Cash). La skill actualiza un archivo de estado (`estado.json`) para llevar el progreso, genera un dashboard HTML visual en cada paso y, al finalizar todas las secciones, produce un archivo Excel completo basado en una plantilla oficial. Es útil para asesores financieros o inversores que deseen organizar y visualizar sus inversiones de forma estructurada, con validación de datos y soporte para múltiples formatos de entrada. La skill está diseñada para plataformas como Claude Code y Cursor, y se apoya en scripts Python para la generación de dashboards y la actualización de la plantilla.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JuanOrtizOvied/portfolio-builder-claude-plugin/tree/HEAD/plugins/portafolio-builder/skills/construir-portafolio
Ver original→Ver todas las habilidades

Preguntar en tu IA favorita

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

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentación

Construir portafolio (modo guiado)

El objetivo es que la persona termine con un dashboard de su portafolio clasificado en las 6 secciones de la plantilla y todas sus subcategorías, con el Excel como descarga opcional. Muchas personas llegan con información incompleta, así que el portafolio se arma por partes: en cada turno se procesa lo que suban, se muestra el avance y se pide lo siguiente.

Archivos de esta skill (rutas relativas a su directorio base):

ArchivoPara qué
references/guia-paso-a-paso.mdCómo guiar a la persona: orden de las secciones, preguntas y tono. Léelo al empezar.
references/reglas-clasificacion.mdCómo decidir la categoría de cada producto. Léelo antes de clasificar.
references/formato-entrada.mdFormato de estado.json, el archivo de avance.
assets/categorias.jsonCódigos de categoría válidos ↔ celdas de la plantilla.
assets/tema.jsonColores y marca del dashboard.
assets/plantilla-portafolio-final.xlsxPlantilla oficial; nunca la edites a mano.
scripts/generar_dashboard.pyGenera el dashboard HTML (también a medio avance).
scripts/llenar_plantilla.pyGenera el Excel final con la plantilla llena.
scripts/importar_excel.pyRecupera el avance desde un Excel generado antes.

Ciclo de cada turno

  1. Retomar o empezar.

    • Si ya existe estado.json en el directorio de trabajo, cárgalo.
    • Si la persona sube un Excel generado antes por este plugin, recupera el avance con python <dir-skill>/scripts/importar_excel.py archivo.xlsx estado.json.
    • Si no hay nada, crea estado.json con cliente, fecha_corte, secciones (las 6 en pendiente) y posiciones: [], y da la bienvenida según la guía.

  2. Procesar lo nuevo. Lee todos los archivos que subió en este turno. Extrae cada posición con su valor de mercado, moneda, institución y página o ubicación. Revisa también las secciones de cash y "otros activos". No adivines números ilegibles: pregúntalos.

  3. Clasificar. Asigna a cada posición un código de assets/categorias.json según references/reglas-clasificacion.md. Si no reconoces un ticker, ISIN o fondo, búscalo antes de clasificarlo. Divide los fondos globales o mixtos según su factsheet. Explica en nota toda clasificación que no sea obvia.

  4. Guardar. Agrega las posiciones a estado.json. Si llega un documento más reciente de la misma cuenta, reemplaza las posiciones anteriores de esa cuenta y avisa. Actualiza secciones solo con lo que la persona confirmó.

  5. Mostrar el avance.

    python <dir-skill>/scripts/generar_dashboard.py estado.json dashboard.html

    Publica dashboard.html como artifact si tienes la herramienta (y en los turnos siguientes actualiza ese mismo artifact); si no, envíalo como archivo. Acompáñalo de un resumen corto: qué se agregó, las dudas puntuales y la siguiente pregunta de la lista de verificación de la guía.

  6. Cerrar cuando las 6 secciones estén en completa o no_aplica:

    python <dir-skill>/scripts/llenar_plantilla.py estado.json "Portafolio_<Nombre>_<AAAA-MM-DD>.xlsx"
python <dir-skill>/scripts/generar_dashboard.py estado.json dashboard.html --excel "Portafolio_<Nombre>_<AAAA-MM-DD>.xlsx"
    • Si llenar_plantilla.py imprime suma_pct distinto de 100 (± 0,05), revisa antes de entregar.
    • Si tienes la skill de Excel (xlsx) con recalc.py, recalcula el archivo y confirma que no haya errores y que Sheet1!D94 = 100 %.
    • Entrega el dashboard como resultado principal, con el botón "Descargar Excel" incluido, y el Excel también como archivo aparte.
    • Recuérdale a la persona que en el Excel le toca completar las columnas en blanco (retornos y portafolio deseado) y seguir las instrucciones de envío de la plantilla.

La persona puede pedir el Excel en cualquier momento, aunque esté incompleto: genéralo y avisa qué secciones faltan.

Reglas

  • Nunca inventes montos. Todo número sale de un documento o de la persona.
  • Usa siempre valor de mercado a la fecha de corte, no el costo.
  • Los porcentajes se calculan sobre el Portafolio de Inversión; EMPRESA_PRIVADA y EXCLUIR no entran en ese total.
  • Una sección solo se marca completa o no_aplica cuando la persona lo confirma.
  • Los documentos tienen datos financieros personales: no los compartas fuera de la conversación.
  • Los colores y la marca del dashboard salen de assets/tema.json; no los cambies por tu cuenta.

Skills relacionados

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community