# Convex Insights

> Query a running Convex app's logs + health in natural language (official MCP): failures, slow/expensive functions, deploy causality — scoped, evidence-backed, with a dashboard deep link.

Source: https://skillsagentes.com/skills/get-convex/agent-skills/convex-insights
Repository: https://github.com/get-convex/agent-skills
Author: get-convex
License: not specified
Updated: hace 13 días
Context cost: 47 tok installed, 1.1k tok once triggered, 1.1k tok with every bundled file
Bundle: 1 file, 4 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add get-convex/agent-skills --skill convex-insights --agent claude-code
```

## What it does

- Envuelve las herramientas de lectura del MCP oficial de Convex (logs, insights, functionSpec, status) para responder preguntas operativas en lenguaje natural
- Descubre nombres reales de funciones y campos antes de consultar, en vez de asumir identificadores
- Elige una de tres vistas (fallos, salud, traza) y filtra el resultado del lado del cliente porque las herramientas no tienen filtro por servidor
- Construye un enlace profundo al dashboard de Convex (dashboard.convex.dev) para verificación humana
- Deriva hallazgos de rendimiento/costo a convex-advisor y defectos de código a convex-reviewer/convex-authz como punteros

## Use it when

- Quieres saber qué está fallando o qué falló después de un deploy
- Necesitas ver funciones lentas o costosas o eventos de OCC/read-limit
- Preguntas por qué falló una llamada concreta (trace por requestId/función)
- Quieres correlacionar un deploy con la aparición de fallos

## Don't bother when

- Para arreglar causas de rendimiento/costo (eso lo posee convex-advisor)
- Para corregir defectos de código (va a convex-reviewer/convex-authz)
- Para reaccionar a errores en vivo hacia adelante (va a monitor/sentinel)

## What triggers it

- "¿Qué funciones están fallando después del último deploy?"
- "Muéstrame por qué falló esta llamada con requestId X"
- "¿Mi deploy rompió algo? Compara los fallos con la versión desplegada"
- "Dame las funciones más lentas o costosas de esta deployment"

## Before you install

- Requiere el MCP oficial de Convex conectado a una deployment en ejecución (lectura únicamente).

## Files

- SKILL.md — 4 KB

## SKILL.md

Not reproduced here. Read it at https://github.com/get-convex/agent-skills/blob/main/skills/convex-insights/SKILL.md

---

Skills Agentes — https://skillsagentes.com/skills/get-convex/agent-skills/convex-insights