| name | analizar-finanzas-personales |
| description | Lee y analiza movimientos financieros registrados cuando el usuario pide totales, balances, categorías o comparaciones. |
Analizar finanzas personales
Descripción
Analiza movimientos financieros ya registrados en Google Sheets.
Puede responder preguntas sobre:
- gastos;
- ingresos;
- balance;
- categorías;
- métodos de pago;
- comercios;
- periodos;
- comparaciones.
Esta skill es de solo lectura.
No debe:
- registrar movimientos;
- modificar filas;
- borrar datos;
- cambiar columnas;
- crear pestañas;
- crear fórmulas;
- dar asesoría de inversión.
Cuándo usar
Usar cuando el usuario pida analizar información financiera registrada.
Ejemplos:
- "¿Cuánto gasté este mes?"
- "¿Cuánto recibí de ingresos en junio?"
- "¿Cuál es mi balance?"
- "¿En qué categoría gasté más?"
- "Compárame junio contra julio."
- "¿Cuánto gasté con tarjeta de crédito?"
- "¿Dónde gasté más dinero?"
También continuar esta skill cuando una pregunta posterior dependa claramente de la consulta anterior.
Ejemplo:
Usuario:
"¿Cuánto gasté este mes?"
Después:
"¿Y cuánto fue en alimentación?"
Mantener el mismo periodo cuando el contexto sea claro.
Cuándo no usar
No activar cuando el usuario quiera registrar un movimiento.
Ejemplos:
- "Gasté 500 en comida."
- "Registra 200 pesos de gasolina."
- "Me depositaron mi sueldo."
Esos casos pertenecen a:
registrar-movimiento-financiero
Tampoco usar para:
- inversión;
- predicciones;
- presupuestos automáticos;
- asesoría financiera profesional.
Prerrequisitos
Antes de analizar:
- consultar
AGENTS.md;
- consultar
TOOLS.md;
- disponer de Google Sheets mediante Composio;
- usar únicamente el destino definido en
TOOLS.md.
Para usar preferencias privadas:
- la conversación debe ser DM;
MEMORY.md debe estar permitido.
No solicitar ni guardar:
- contraseñas;
- tokens;
- API keys;
- credenciales.
No modificar Google Sheets durante el análisis.
Procedimiento paso a paso
1. Interpretar la consulta
Identificar:
- qué quiere medir;
- periodo;
- filtros;
- agrupación;
- comparación.
Ejemplo:
"¿Cuánto gasté en alimentación en junio?"
Interpretar:
- métrica: gasto total;
- tipo: Gasto;
- categoría: Alimentación;
- periodo: junio.
Si falta información necesaria, pedir aclaración.
2. Resolver el periodo
Interpretar expresiones como:
- hoy;
- ayer;
- esta semana;
- este mes;
- mes pasado;
- un mes específico;
- entre dos fechas;
- últimos 7 días;
- últimos 30 días.
Convertirlas internamente en fechas concretas.
Si el periodo es ambiguo, preguntar.
No inventarlo.
3. Definir filtros
Aplicar solo los filtros necesarios:
fecha;tipo;categoria;metodo de pago;lugar/comercio.
No añadir filtros que el usuario no pidió.
4. Leer los datos
Leer únicamente desde el destino oficial definido en TOOLS.md.
No:
- escribir;
- modificar;
- borrar;
- crear filas;
- crear columnas;
- cambiar la estructura.
5. Validar los datos
Para cálculos numéricos, comprobar:
- fecha válida;
- tipo;
- monto.
Para agrupaciones, comprobar también el campo correspondiente.
No inventar valores faltantes.
Si una fila no puede analizarse con seguridad:
- excluirla solo cuando sea necesario;
- informar la limitación si puede afectar el resultado.
6. Tratar cada fila como un movimiento
Cada fila registrada debe contar como un movimiento independiente.
No excluir una fila solo porque:
- tenga el mismo monto;
- tenga la misma fecha;
- tenga una descripción similar.
Dos movimientos iguales pueden ser reales.
Solo excluir un registro cuando exista una razón explícita y verificable.
7. Separar gastos e ingresos
Para gastos:
Para ingresos:
Para balance:
ingresos - gastos
No mezclar ambos tipos en otras métricas salvo que la consulta lo requiera.
8. Revisar monedas
No mezclar monedas distintas en un mismo total.
Si los datos contienen más de una moneda y no existe una conversión explícita:
- separar los resultados por moneda; o
- pedir aclaración.
No inventar tipos de cambio.
9. Aplicar filtros
Aplicar exactamente:
- periodo;
- tipo;
- categoría;
- método de pago;
- comercio;
cuando correspondan.
No incluir movimientos fuera del alcance solicitado.
10. Calcular
Según la consulta:
Total
Sumar monto.
Conteo
Contar movimientos.
Balance
Calcular:
ingresos - gastos
Categoría
Agrupar y sumar por categoria.
Método de pago
Agrupar y sumar por metodo de pago.
Comercio
Agrupar y sumar por lugar/comercio.
Comparación
Calcular cada periodo por separado y después comparar.
Puede indicar:
- diferencia absoluta;
- aumento;
- disminución.
No calcular porcentajes cuando no exista una base válida.
11. Verificar
Antes de responder, comprobar:
- periodo correcto;
- tipo correcto;
- filtros correctos;
- filas incluidas;
- montos válidos;
- cálculo consistente.
En comparaciones, validar cada periodo por separado.
12. Responder
Dar primero el resultado principal.
Después, agregar solo el desglose necesario.
Ejemplo:
Gastaste $3,200 este mes en 18 movimientos.
Desglose:
- Alimentación: $1,200
- Transporte: $800
- Diversión y salidas: $700
- Otros: $500
Indicar claramente el periodo analizado.
13. Cerrar
Finalizar con:
ANALISIS_COMPLETADO
solo cuando:
- la consulta fue entendida;
- se leyeron los datos;
- se aplicaron los filtros;
- se realizó el cálculo;
- se verificó el resultado;
- el usuario recibió una respuesta clara.
Análisis soportados
Totales
- gasto total;
- ingreso total;
- balance.
Conteos
- número de gastos;
- número de ingresos;
- número de movimientos.
Categorías
- gasto por categoría;
- categoría de mayor gasto;
- comparación entre categorías.
Métodos de pago
- gasto por método;
- número de movimientos por método.
Comercios
- gasto por comercio;
- comercio con mayor gasto.
Solo usar registros con lugar/comercio disponible.
Comparaciones
- periodo contra periodo;
- mes contra mes;
- semana contra semana;
- categoría contra categoría.
Salida esperada verificable
Estados posibles:
ANALISIS_COMPLETADOESPERANDO_ACLARACIONSIN_DATOSDATOS_INSUFICIENTESERROR_DE_HERRAMIENTA
Éxito
ANALISIS_COMPLETADO
Solo cuando:
- la consulta fue entendida;
- el periodo fue definido;
- los datos necesarios fueron leídos;
- los filtros fueron correctos;
- el cálculo fue verificado;
- la respuesta indica claramente qué se analizó.
Casos especiales
Falta información necesaria
Preguntar.
Estado:
ESPERANDO_ACLARACION
Periodo ambiguo
No asumir.
Preguntar.
Estado:
ESPERANDO_ACLARACION
No existen movimientos
Informar claramente.
Estado:
SIN_DATOS
Datos insuficientes
Explicar qué información falta.
Estado:
DATOS_INSUFICIENTES
Filas incompletas
No inventar valores.
Usar únicamente los datos analizables.
Advertir si la omisión puede afectar el resultado.
Varias monedas
Separar resultados por moneda o pedir aclaración.
No inventar conversiones.
Google Sheets o Composio falla
No inventar resultados.
Estado:
ERROR_DE_HERRAMIENTA
Falta conexión autorizada
No pedir secretos por chat.
Estado:
ERROR_DE_HERRAMIENTA
Registro y análisis en la misma petición
Primero completar:
registrar-movimiento-financiero
Después ejecutar:
analizar-finanzas-personales
No analizar un movimiento que todavía no fue confirmado y registrado.
Consulta fuera del alcance
No inventar:
- predicciones;
- recomendaciones de inversión;
- asesoría financiera.
Explicar brevemente el límite.
Dependencias
Herramientas
- Google Sheets mediante Composio.
Archivos
AGENTS.mdTOOLS.mdMEMORY.md, solo cuando esté permitido.
Skill relacionada
registrar-movimiento-financiero
No es obligatoria para análisis de datos ya existentes.
No necesarias por ahora
docs.mdscripts/references/- MCP adicional
- acceso adicional a Google Drive
- APIs nuevas
