convex-performance-audit
Installation
Summary
Diagnose and resolve Convex performance issues across reads, writes, subscriptions, and function limits.
- Covers four problem classes: hot-path reads and data amplification, OCC write conflicts and contention, subscription cost and reactivity overhead, and function execution or transaction size limits
- Starts with signal gathering from deployment health insights or CLI tools, then routes to the relevant reference guide based on the problem type
- Emphasizes tracing full read and write sets, identifying sibling functions on the same tables, and fixing patterns consistently across related code paths
- Includes guardrails against over-engineering small-scale or low-traffic applications, and escalation guidance for invasive fixes requiring migration-safe rollouts
SKILL.md
Convex Performance Audit
Diagnose and fix performance problems in Convex applications, one problem class at a time.
When to Use
- A Convex page or feature feels slow or expensive
npx convex insights --detailsreports high bytes read, documents read, or OCC conflicts- Low-freshness read paths are using reactivity where point-in-time reads would do
- OCC conflict errors or excessive mutation retries
- High subscription count or slow UI updates
- Functions approaching execution or transaction limits
- The same performance pattern needs fixing across sibling functions
When Not to Use
Related skills
More from get-convex/agent-skills
convex-quickstart
Creates or adds Convex to an app. Use for new Convex projects, npm create
46.5Kconvex-setup-auth
Sets up Convex auth, identity mapping, and access control. Use for login, auth
45.9Kconvex-migration-helper
Plans Convex schema and data migrations with widen-migrate-narrow and
45.8Kconvex-create-component
Builds reusable Convex components with isolated tables and app-facing APIs.
45.8Kconvex
Routes general Convex requests to the right project skill. Use when the user
22.3Kconvex-helpers-guide
Discover and use convex-helpers utilities for relationships, filtering, sessions, custom functions, and more. Use when you need pre-built Convex patterns.
572