convex-performance-audit
Audits Convex performance for reads, subscriptions, write contention, and function limits. Use for slow features, insights findings, OCC conflicts, or read amplification.
Install
Install this Claude and Codex skill with the command below. The command stays visible even when copy support is unavailable.
git clone https://github.com/get-convex/agent-skills /tmp/agent-skills && ln -s /tmp/agent-skills/skills/convex-performance-audit ~/.claude/skills/convex-performance-auditFrom README
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 --details reports 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 Initial Convex , auth , or component extraction Pure schema migrations with no performance goal One-off micro-optimizations without a user-visible or deployment-visible problem Guardrails Prefer simpler code when scale is small, traffic is modest, or the available signals are weak Do not recommend digest tables, document splitting, fetch-strategy changes, or migration-heavy rollouts unless there is a measured signal,...