AVISO: Solo con fines educativos e informativos. No constituye asesoramiento financiero.
Objetivo
Compila todos los análisis en markdown de los archivos FINANCE-*.md del directorio de trabajo actual en un único PDF pulido, que un asesor, familiar o socio de rendición de cuentas pueda leer de principio a fin.
Cuándo activar
- El usuario escribe
/finance report-pdfo/finance pdf - El usuario pide «crear un informe en PDF», «dame un documento listo para el cliente», «exportar mi plan financiero»
- Después de ejecutar
/finance analyze(sugerirlo como el siguiente paso natural)
Requisitos previos
Antes de generar, asegúrate de que el usuario tenga al menos un archivo de análisis en el directorio de trabajo actual:
FINANCE-ANALYSIS.md(de/finance analyze) — entrada principalFINANCE-BUDGET.mdFINANCE-DEBT.mdFINANCE-RETIREMENT.mdFINANCE-PORTFOLIO.mdFINANCE-EMERGENCY.mdFINANCE-NETWORTH.mdFINANCE-GOALS.mdFINANCE-COMPARE.mdFINANCE-SCREEN.mdFINANCE-FIRE.mdFINANCE-TAXES.md
Si no se encuentra ningún archivo, pídele al usuario que primero ejecute /finance analyze o /finance quick.
Proceso
Etapa 1: Exploración de archivos de origen
ls FINANCE-*.mdLee todos los archivos encontrados. El script generador en Python también realiza su propio escaneo; el asistente los lee previamente para validar la calidad del contenido e identificar brechas evidentes antes de la generación.
Etapa 2: Extracción de datos
Obtén de los archivos markdown:
- Puntuación compuesta de salud financiera (0-100) y calificación con letra
- Subpuntuaciones para cada una de las 5 categorías (Flujo de caja, Deuda, Inversiones, Jubilación, Protección)
- Puntos clave de datos financieros:
- Ingresos / gastos / excedente mensual
- Tasa de ahorro
- Patrimonio neto
- Deuda total y DTI (deuda sobre ingresos)
- Meses cubiertos por el fondo de emergencia
- Saldo proyectado de jubilación vs. saldo necesario
- Asignación de activos
- Elementos de acción (ordenados por prioridad)
- Nombre del usuario / nombre del hogar (si se proporciona)
- Fecha de generación
Etapa 3: Ejecutar el generador de PDF
Ejecuta:
Bash(python3 ~/.claude/skills/finance/scripts/generate_finance_pdf.py)El script lee todos los archivos FINANCE-*.md del directorio de trabajo actual, analiza las secciones estructuradas y crea un PDF con ReportLab.
Si falta el script o presenta errores, recurre de forma controlada a un informe consolidado solo en Markdown llamado FINANCE-PLAN.md e informa al usuario.
Etapa 4: Confirmar salida
Después de generar:
- Verifica si
FINANCE-PLAN.pdfexiste en el directorio de trabajo actual - Informa al usuario el tamaño del archivo y el número de páginas
- Sugiere compartirlo con tu asesor financiero / contador público (CPA)
Estructura del PDF
El generador produce las siguientes secciones:
Página de portada
- Título: "Plan financiero personal"
- Nombre del usuario / hogar
- Fecha
- Medidor de puntuación compuesta de salud financiera (visual de 0-100)
- Calificación con letra (de A+ a F)
- Señal de una línea ("Excelente — solo optimizaciones menores")
- Pie de página con aviso legal
Página 2: Resumen ejecutivo
- Top 3 fortalezas
- Top 3 brechas prioritarias
- Enfoque de este trimestre (una sola frase)
- Tabla de cifras clave:
- Patrimonio neto
- Excedente mensual
- Tasa de ahorro
- DTI
- Meses de emergencia
Página 3: Detalle de la puntuación de salud financiera
- Gráfico de barras de las puntuaciones de las 5 categorías
- Cada categoría: puntuación / peso / qué mide / señal
Página 4: Flujo de caja y presupuesto
- Gráfico de ingresos vs. gastos
- Top 5 categorías de gastos
- Tendencia del excedente
- Ajustes de presupuesto recomendados
Página 5: Perfil de deuda
- Deuda total por tipo (tabla)
- APR (Tasa Porcentual Anual) promedio
- Cronograma de pago (método avalancha)
- Costo de intereses en la trayectoria actual frente a la acelerada
Página 6: Perspectiva de jubilación
- Años hasta la jubilación
- Saldo actual vs. referencia por edad
- Saldo proyectado al jubilarte (3 escenarios: conservador / moderado / agresivo)
- Saldo necesario para el estilo de vida deseado
- Análisis de brechas
- Tasa de contribución recomendada
Página 7: Cartera de inversiones
- Gráfico circular de la asignación actual
- Gráfico circular de la asignación recomendada
- Desviación / necesidades de rebalanceo
- Análisis de la tasa de gastos
- Puntuación de diversificación
Página 8: Protección financiera
- Estado del fondo de emergencia
- Matriz de cobertura de seguros (salud, vida, incapacidad, auto, hogar)
- Checklist de planificación sucesoria (testamento, beneficiarios, poder notarial, directiva de atención médica)
- Brechas y prioridades para cubrirlas
Páginas 9-10: Plan de acción
- Prioridades de 30 días
- Prioridades de 90 días
- Prioridades de 1 año
- Prioridades de 5 años
- Cada acción incluye: monto específico, cuenta/vehículo específico, fecha de vencimiento
Página final: Divulgaciones y glosario
- Aviso legal completo
- Notas sobre la metodología
- Glosario de términos (DTI, SWR, ER, etc.)
- "Próximos pasos" — cuándo consultar a profesionales
Patrones de diseño visual
- Paleta de colores: Azul (#1f4e79) primario, verde para métricas positivas, ámbar para avisos, rojo para aspectos críticos
- Tipografía: Sans serif para los títulos, serif para el cuerpo
- Gráficos: Limpios, con cuadrículas mínimas y etiquetas en lenguaje sencillo
- Medidores: Escala de 0 a 100 con zonas codificadas por color (rojo <40, ámbar 40-69, verde 70+)
- Tablas: Sombreado alternado de filas, números alineados a la derecha, formato de moneda con separadores de miles
Tono y lenguaje
- Inglés sencillo, sin jerga excesiva
- Números específicos, nunca rangos vagos
- Empático con respecto a las discapacidades, concreto en cuanto a las acciones
- Confianza en los puntos fuertes
Tratamiento de errores
| Error | Respuesta |
|---|---|
| No se encontró ningún archivo FINANCE-*.md | «Ejecuta /finance analyze o /finance quick primero para generar los datos de entrada." |
| Falta el script de Python | Genera FINANCE-PLAN.md consolidado en su lugar; indica al usuario cómo instalar ReportLab |
| ReportLab no está instalado | Indica: pip3 install reportlab |
| Markdown vacío/malformado | Omitir esta sección, generar el PDF sin ella y anotarlo en el resumen |
| Generación del PDF exitosa, pero el archivo pesa menos de 50KB | Probablemente no hay datos; avísale al usuario |
Opciones de personalización
Si el usuario quiere personalizar:
- Nombre en la portada — Pregunta el nombre del hogar para mostrarlo
- Secciones selectivas — Permite
/finance report-pdf --sections=debt,retirementpara limitar el alcance - Marca — Si se usará con fines de consultoría, permite ingresar la ruta del logotipo
- Moneda — USD predeterminado; permite reemplazarlo
Flujo de ejemplo de invocación
Usuário: /finance report-pdf
Assistente: Varrendo o diretório atual em busca de arquivos FINANCE-*.md...
Encontrados: FINANCE-ANALYSIS.md, FINANCE-DEBT.md, FINANCE-RETIREMENT.md, FINANCE-BUDGET.md
Gerando PDF...
[executa Bash(python3 ~/.claude/skills/finance/scripts/generate_finance_pdf.py)]
Concluído. Gerado FINANCE-PLAN.pdf (12 páginas, 487 KB).
Principais conclusões:
- Pontuação de Saúde Financeira: 72/100 (Nota B)
- Área mais forte: Gestão de Dívida (88/100)
- Área mais fraca: Preparação para Aposentadoria (52/100)
- Ação principal: Aumentar a contribuição do 401k de 6% para 12% para capturar o match completo
Próximo passo recomendado: Compartilhe este PDF com seu CPA antes do planejamento fiscal de fim de ano.
AVISO: Apenas para fins educacionais/informativos. Não constitui aconselhamento financeiro.Lista de verificación de validación
Antes de declarar el éxito, verifica:
- [ ] El archivo PDF existe en la ruta esperada
- [ ] Tamaño del archivo > 50KB (verificación aproximada de cordura)
- [ ] El aviso legal aparece en la portada y en la página final
- [ ] Todas las puntuaciones de categoría están presentes (no "N/D" en todo)
- [ ] Al menos 3 acciones en el plan
AVISO: Solo con fines educativos e informativos. No constituye asesoramiento financiero. El PDF generado recopila análisis producidos por IA con base en datos proporcionados por el usuario. Consulta siempre a un asesor financiero con licencia, CPA o profesional de impuestos antes de tomar decisiones financieras importantes. El rendimiento pasado no garantiza resultados futuros.
--- skills/finance-quick/SKILL.md ---
name: finance-quick description: Instantánea Financiera de 60 Segundos — evaluación rápida de la salud financiera basada en seis datos principales (ingresos, gastos, ahorros, deuda, edad, meta de jubilación). Sin subagentes. Genera una tarjeta de puntuación compacta en el terminal con la tasa de ahorro, la relación DTI, la cobertura del fondo de emergencia, el estado del progreso de jubilación y las 3 acciones prioritarias principales en menos de 40 líneas.