What problem does it solve?
This Skill helps diagnose and resolve performance problems in Convex applications by narrowing the root cause across reads, subscriptions, OCC conflicts, and function limits.
Core Features & Use Cases
- Problem-class performance diagnosis: Identifies whether the bottleneck is hot-path read amplification, OCC/write contention, subscription invalidation cost, or function/transaction budget issues.
- Signal-driven starting point: Uses the strongest available inputs first, including deployment Health insights and
npx convex insights --details, with fallbacks to a code-first audit.
- Scoped, end-to-end workflow auditing: Traces a single concrete user flow to map the full read/write set, including sibling endpoints and reactivity touchpoints.
- Reference-guided, least-invasive changes: Applies fix patterns from the matching reference file and escalates only when changes are invasive or migration-heavy.
- Verification to prevent regressions: Confirms correctness, expected read/write elimination, fallback behavior, and consistent sibling updates.
Quick Start
Ask the Skill to audit your Convex app for slow reads and high OCC conflict rates by using npx convex insights --details, then trace the relevant user flow to apply the smallest high-impact fix consistent with the applicable reference guides.