convex-performance-audit

Diagnose and fix Convex performance issues across reads, subscriptions, and write contention.

Updated May 22, 2026
One-click install
npx skills add https://github.com/ekawijayasusilo/kmp_template --skill convex-performance-audit-ekawijayasusilo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-performance-audit
Source: https://github.com/ekawijayasusilo/kmp_template/tree/main/.claude/skills/convex-performance-audit
Command: npx skills add https://github.com/ekawijayasusilo/kmp_template --skill convex-performance-audit-ekawijayasusilo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

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.

Frequently Asked Questions about convex-performance-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose slow Convex pages and high OCC conflict rates?

Diagnose slow Convex pages and high OCC conflicts by gathering signals from deployment Health insights and `npx convex insights --details`, then tracing the user flow to map read/write sets. This identifies whether bottlenecks stem from read amplification or write contention.

What causes excessive mutation retries and OCC conflicts in Convex applications?

OCC conflicts and mutation retries in Convex are caused by write contention on hot paths. Auditing traces the user flow to map write sets and applies least-invasive reference-guided fixes to reduce contention and eliminate excessive retries.

How do I reduce high insight bytes and documents read in Convex subscriptions?

Reduce high insight bytes and document reads in Convex subscriptions by auditing the full read set and sibling endpoints. The audit identifies subscription invalidation costs and applies targeted fixes to eliminate unnecessary reactivity and reads.

Why are my Convex functions approaching execution or transaction limits?

Convex functions approach execution or transaction limits when read/write sets expand uncontrollably. Auditing traces the full flow to identify budget risks and applies guardrail-compliant, least-invasive fixes to reduce cost and prevent failures.

Can I audit Convex performance without deployment Health insights?

You can audit Convex performance without Health insights by falling back to a code-first audit. The workflow traces a single concrete user flow to map the full read/write set, including sibling endpoints and reactivity touchpoints, to identify bottlenecks.

How do I verify that Convex performance fixes prevent regressions?

Verify Convex performance fixes by confirming correctness, expected read/write elimination, fallback behavior, and consistent sibling updates. This verification step ensures the applied least-invasive changes reduce cost without introducing new issues.