Skill: reporting
Reportes profesionales. Que tus análisis no mueran en un notebook.
Trigger
- Terminaste un análisis y necesitás presentarlo
- Querés automatizar informes periódicos
- Necesitás exportar resultados a PDF, HTML o Markdown
- El cliente quiere algo que pueda leer sin abrir Python
Workflow LEND
1. ANALIZAR
├── Audiencia: ¿técnica, ejecutiva, cliente? define el nivel de detalle
├── Formato: ¿PDF formal, HTML interactivo, Markdown para GitHub?
├── Contenido: tablas, gráficos, conclusiones, recomendaciones
└── Frecuencia: one-shot o reporte automático recurrente
2. OFRECER (Menú del Senior)
├── A) Markdown + Quarto — liviano, versionable, ideal para GitHub
├── B) HTML + Jinja2 — templates custom, gráficos embebidos, interactivo
└── C) PDF con ReportLab — formal, exportable, para clientes
3. ELEGIR → confirmación
4. HACER
├── Estructura: resumen ejecutivo → metodología → resultados → conclusiones
├── Tablas: Pandas + styler para formato condicional
├── Gráficos: Matplotlib/Seaborn con configuración publicable
├── Markdown/Quarto: .qmd con código + texto + gráficos
├── HTML: Jinja2 template con CSS custom
└── PDF: ReportLab o WeasyPrint para PDFs desde HTML
5. VERIFICAR
├── El reporte se lee bien sin necesidad de ejecutar código
├── Los números son consistentes entre tablas y texto
└── Las conclusiones están justificadas por los datos mostrados
Patrones
- Resumen ejecutivo primero: que alguien pueda leer solo la primera página y entender todo
- Una tabla, un mensaje: no pongas tablas sin contexto. Cada tabla responde una pregunta.
- Gráfico publicable: 300 DPI, leyenda, etiquetas, colores accesibles
- Reproducible: el reporte se genera con un comando, no a mano
- Automático: si es recurrente, que se genere solo y se mande solo
Anti-patrones
- ❌ Reportes de 50 páginas que nadie lee — lo importante en las primeras 2 páginas
- ❌ Tablas sin contexto — "acá están los números" no es análisis
- ❌ Gráficos en baja calidad — borrosos, ilegibles en PDF
- ❌ Reportes manuales — si hay que armarlos a mano cada vez, están mal diseñados
- ❌ Sin fecha/versión — "esto es de la semana pasada o del mes pasado?"
1---2name: reporting3description: Genera reportes profesionales en HTML, PDF y Markdown, con tablas, gráficos y conclusiones, para presentar análisis de forma clara y reproducible.4license: MIT5---67# Skill: reporting89Reportes profesionales. Que tus análisis no mueran en un notebook.1011## Trigger1213- Terminaste un análisis y necesitás presentarlo14- Querés automatizar informes periódicos15- Necesitás exportar resultados a PDF, HTML o Markdown16- El cliente quiere algo que pueda leer sin abrir Python1718## Workflow LEND1920```211. ANALIZAR22 ├── Audiencia: ¿técnica, ejecutiva, cliente? define el nivel de detalle23 ├── Formato: ¿PDF formal, HTML interactivo, Markdown para GitHub?24 ├── Contenido: tablas, gráficos, conclusiones, recomendaciones25 └── Frecuencia: one-shot o reporte automático recurrente26272. OFRECER (Menú del Senior)28 ├── A) Markdown + Quarto — liviano, versionable, ideal para GitHub29 ├── B) HTML + Jinja2 — templates custom, gráficos embebidos, interactivo30 └── C) PDF con ReportLab — formal, exportable, para clientes31323. ELEGIR → confirmación33344. HACER35 ├── Estructura: resumen ejecutivo → metodología → resultados → conclusiones36 ├── Tablas: Pandas + styler para formato condicional37 ├── Gráficos: Matplotlib/Seaborn con configuración publicable38 ├── Markdown/Quarto: .qmd con código + texto + gráficos39 ├── HTML: Jinja2 template con CSS custom40 └── PDF: ReportLab o WeasyPrint para PDFs desde HTML41425. VERIFICAR43 ├── El reporte se lee bien sin necesidad de ejecutar código44 ├── Los números son consistentes entre tablas y texto45 └── Las conclusiones están justificadas por los datos mostrados46```4748## Patrones4950- **Resumen ejecutivo primero**: que alguien pueda leer solo la primera página y entender todo51- **Una tabla, un mensaje**: no pongas tablas sin contexto. Cada tabla responde una pregunta.52- **Gráfico publicable**: 300 DPI, leyenda, etiquetas, colores accesibles53- **Reproducible**: el reporte se genera con un comando, no a mano54- **Automático**: si es recurrente, que se genere solo y se mande solo5556## Anti-patrones5758- ❌ Reportes de 50 páginas que nadie lee — lo importante en las primeras 2 páginas59- ❌ Tablas sin contexto — "acá están los números" no es análisis60- ❌ Gráficos en baja calidad — borrosos, ilegibles en PDF61- ❌ Reportes manuales — si hay que armarlos a mano cada vez, están mal diseñados62- ❌ Sin fecha/versión — "esto es de la semana pasada o del mes pasado?"
LeandroBenjaminL