resumen-semanal
El formato y los criterios del resumen semanal automático de crecimiento (corrida del cron de los lunes; también si un socio pide "el resumen de la semana").
SKILL.mdserver/skills/finzen/resumen-semanal/SKILL.md
GitHubResumen semanal de crecimiento
Un documento que un socio lee en 3 minutos un lunes por la mañana y sabe: cómo vamos, qué funcionó, y qué hacer esta semana. Datos → lectura → acción. Nunca un vertedero de números.
1. Datos (siempre en este orden, siempre de tools)
get_kpisde la semana que cerró (lunes a domingo).get_kpisde la semana anterior — para comparar.get_campaign_resultsdel período — campañas medidas y su lift.- Si algo se sale de lo normal (caída/salto fuerte),
evaluate_segmentde los segmentos relacionados para dimensionar (ej. cayó retención → ¿creciódormant?). - Marketing (es el otro ámbito, pero el resumen es uno solo):
list_marketing_accounts→get_instagram_profilede la cuenta de FinZen (y hasta 3 competidores guardados) + el skilllectura-perfil-instagrampara el criterio;get_tiktok_profilede la cuenta de FinZen + el skilllectura-perfil-tiktok(otro criterio: mediana de views y compartidos);get_meta_spendde la semana si Meta está configurado. La comparación semanal de Instagram eshistorico.delta_7d(si esnull, no hay lectura de hace 7 días: se dice, no se estima). Si algo no está configurado o falta un permiso, la sección lo dice en una línea — se omite el dato, nunca la sección.
2. Estructura del documento
# Resumen semanal de crecimiento — {YYYY-MM-DD}
**Período:** {lunes} al {domingo} · Generado por Kaizen
## En una línea
La lectura de la semana en una frase honesta.
## Los números que importan (vs semana anterior)
3-5 movimientos RELEVANTES, cada uno: cifra actual, delta, y una línea de
lectura. No listar todos los KPIs — elegir los que cuentan la historia.
## Campañas
Por cada campaña medida: nombre, segmento, lift (o pre/post con su disclaimer)
y qué aprendimos. Si no hubo campañas: decirlo y qué oportunidad se perdió.
## Redes y pauta
Instagram de FinZen: seguidores y su delta de 7 días (con la distancia real
si no es 7), tasa de engagement y mediana de likes con la referencia de
tamaño dicha como referencia, y —si hay insights— alcance, guardados y taps
al link. Los taps van AL LADO de los registros atribuidos a instagram de
`get_kpis`: es el puente entre las redes y el negocio. TikTok de FinZen: seguidores a 30 y 7 días
(si hubo un salto, a qué video se debe), mediana de views, engagement sobre
views y lo más compartido. Competidores guardados (solo Instagram):
una línea cada uno, tasa comparada por tamaño, nada de "les va mejor". Meta:
gasto de la semana en la moneda de la cuenta y qué campañas gastaron de
verdad (`effective_status`); el CAC combinado SOLO si los nombres de campaña
unen con `utm_campaign`, y si no unen, decirlo. Sin credenciales o sin
perfiles guardados: una línea que lo diga, y seguir.
## Recomendaciones para esta semana (2-3)
Cada una: acción concreta + el dato que la respalda + impacto esperado.
Si una implica campaña: segmento con count real (evaluate_segment), mensaje
sugerido y medición — pero NO crearla (los socios la piden por chat si convence).
## Vigilar
1-2 señales a observar esta semana (métricas cerca de un umbral, experimentos
en ventana de medición).
3. Criterios de calidad
- Honestidad primero: si la semana fue mala, la primera línea lo dice. Un resumen que maquilla es peor que no tener resumen.
- Pagar ≠ tener un plan.
plan_distributionincluye a los que están en prueba gratis: no lo reportes como "usuarios de pago" ni sumes sus categorías. Cruza siempre contramrr_usdytrials.active; si el total no cuadra con los precios de los planes, di el desglose por plan y cuántos están en prueba en vez de inventar un número de pagos. - Toda campaña que menciones lleva su estado y su fecha real. Las del bloque
campaignsya se enviaron (sent_ates la fecha de publicación, úsala tal cual). Un borrador que creaste y sigue en PENDING_APPROVAL no salió: dilo así, nunca lo reportes junto a las enviadas sin distinguirlo. - Deltas con contexto: "MRR $1,480 (+3.2%)" y no "$1,480". Registros bajos en semana de asueto → decir el contexto, no gritar tendencia.
- Ojo con muestras chicas: cambios porcentuales grandes sobre números chicos (3→6 trials = "+100%") se reportan en absolutos.
- Cada recomendación es accionable esta semana — no "mejorar la retención" sino "campaña a los 95 dormidos FREE de 30+ días con gancho de racha".
- Convención de la API: los
*_pctson puntos (31.0 = 31%). - En redes, likes son pulso. "La pieza que más llamó la atención" sí;
"la pieza que funcionó" solo con guardados y alcance (skill
lectura-perfil-instagram). Un delta de seguidores menor al 1 % del total en la semana se reporta como "estable", sin adjetivo.
4. Entrega
save_cerebro_note (título resumen-semanal-{YYYY-MM-DD}, fecha del lunes
de generación) — sin pasar subcarpeta, para que caiga en 50-kaizen/, que es
donde el socio revisa los lunes. NUNCA a Contenidos/assets (esa es para piezas
de redes ya terminadas, no para reportes). Formato Markdown con la estructura de
arriba.