What problem does it solve? Convex applications can become slow or expensive due to read amplification, OCC write conflicts, excessive reactive subscriptions, or functions hitting execution and transaction limits. This Skill provides a structured audit workflow that starts from real signals like npx convex insights --details and routes each symptom to a targeted fix guide. ## Core Features & Use Cases - Signal-driven diagnosis: Gathers evidence from Convex deployment health insights, CLI insights, or code audits before recommending any change, with guardrails against over-engineering small-scale apps. - Four problem-class playbooks: Reference guides cover hot-path read amplification and indexes, OCC conflict resolution and hot document splitting, subscription cost reduction, and function budget limits with batching patterns. - Sibling-function consistency: When one query or mutation is fixed, the workflow audits all sibling readers and writers on the same tables so the same pattern is fixed everywhere. - Use Case: Your dashboard shows OCC conflict errors on a shared counter document. The Skill routes you to the OCC reference, which walks you through sharding the counter and moving non-critical bookkeeping to scheduled functions. ## Quick Start Ask the assistant to audit your Convex app for performance issues, starting with the strongest available signal such as insights output or a slow page.
