CommunityRedacción y edicióngithub.com

get-convex/convex-performance-audit

Audita el rendimiento de Convex en lecturas, suscripciones, contención de escritura y límites de funciones. Útil para funciones lentas, hallazgos de insights, conflictos OCC o amplificación de lectura.

¿Qué es convex-performance-audit?

Esta habilidad, `get-convex/convex-performance-audit`, está diseñada para desarrolladores que trabajan con la plataforma Convex y necesitan diagnosticar problemas de rendimiento. Realiza una auditoría exhaustiva del rendimiento de la base de datos y las funciones, cubriendo áreas críticas como la eficiencia de las lecturas de datos, el manejo de suscripciones en tiempo real, la contención de escrituras que puede provocar conflictos de concurrencia optimista (OCC), y el cumplimiento de los límites de ejecución de funciones. Es especialmente útil cuando una función específica es lenta, cuando las herramientas de monitoreo (como los insights de Convex) señalan un cuello de botella, o cuando se observan repetidos conflictos OCC o una amplificación de lectura (lectura excesiva de datos en relación con lo necesario). La auditoría analiza el código y la configuración del proyecto en busca de patrones que puedan degradar el rendimiento y proporciona recomendaciones accionables para optimizarlo. Es compatible con cualquier proyecto que utilice Convex como backend, ya que se integra directamente con su stack y sus APIs.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/get-convex/agent-skills/tree/main/skills/convex-performance-audit

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace convex-performance-audit?

Audita el rendimiento de Convex en lecturas, suscripciones, contención de escritura y límites de funciones. Útil para funciones lentas, hallazgos de insights, conflictos OCC o amplificación de lectura.


Esta habilidad analiza el rendimiento de tu proyecto Convex, enfocándose en:

  • Lecturas: Identifica consultas ineficientes, falta de índices o carga excesiva de datos.
  • Suscripciones: Detecta suscripciones que pueden estar causando una sobrecarga de actualizaciones en el cliente.
  • Contención de escritura: Encuentra conflictos de concurrencia optimista (OCC) y sugiere mejores estrategias de escritura.
  • Límites de funciones: Verifica si alguna función está cerca de los límites de ejecución (tiempo, tamaño de respuesta, etc.) y sugiere optimizaciones.

¿Cómo usarla?

  1. Ejecuta el comando de auditoría (ajusta según tu flujo de trabajo):

    npx convex performance-audit
    
  2. Revisa el informe generado, que incluirá secciones como:

    - Lecturas lentas detectadas en la función `getUserData`.
    - Suscripción `onMessage` con alta frecuencia de actualizaciones.
    - Posible contención en `updateBalance`.
    - Función `processBatch` cerca del límite de tiempo (5s).
    
  3. Aplica las recomendaciones (ej. añadir índices, optimizar queries, usar mutaciones por lotes).

Plataformas compatibles: Claude Code, Cursor, Codex, y cualquier agente que lea SKILL.md.

Nota: Asegúrate de que tu proyecto tenga convex instalado y configurado. El auditor utiliza las APIs de Convex para obtener métricas y analizar el código fuente.


Para más detalles, consulta la documentación oficial de Convex sobre rendimiento.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

Skills relacionados