# Convex Advisor

> Read the Convex deployment's 72h insights (read limits, OCC contention), root-cause each event in code, report evidence-backed perf/cost findings with fixes.

Source: https://skillsagentes.com/skills/get-convex/agent-skills/convex-advisor
Repository: https://github.com/get-convex/agent-skills
Author: get-convex
License: not specified
Updated: hace 13 días
Context cost: 39 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-advisor --agent claude-code
```

## What it does

- Lee los eventos de salud de 72h del deployment de Convex vía la herramienta insights del MCP oficial (límites de lectura, contención OCC)
- Root-causea cada evento leyendo el código real de la función marcada
- Emite findings evidenciados en el bus specs/finding.schema.json con severidad, locus y evidencia
- Reporta hallazgos ordenados por severidad con evidencia en runtime, causa raíz con file:line y el fix concreto
- Ofrece aplicar los fixes solo tras confirmación, sin mutar nunca el deployment

## Use it when

- Quieres saber qué funciones están golpeando límites de lectura o sufriendo contención OCC en producción
- Necesitas evidencia real de 72h de tráfico en vez de una revisión estática de código
- Quieres priorizar findings de performance/costo por severidad con causa raíz en el código

## Don't bother when

- El insights tool no está disponible (previews o contextos con deploy-key) o no hay ~72h de tráfico: usa convex-reviewer en su lugar
- El hallazgo es de autorización (usa convex-authz), estilo/idioma de código (convex-reviewer) o triage de errores (sentinel)

## What triggers it

- "Revisa los insights de 72h de mi deployment de Convex y dime qué funciones tienen problemas"
- "¿Por qué esta función está fallando por contención OCC en producción?"
- "Analiza el consumo de lecturas de mis funciones de Convex y sugiere índices o paginación"

## Before you install

- Requiere el MCP oficial de Convex con la herramienta insights, disponible solo en deployments cloud dev/prod logueados como usuario (no en previews ni contextos con deploy-key) y con ~72h de tráfico acumulado.

## Files

- SKILL.md — 4 KB

## SKILL.md

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

---

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