convex-performance-audit

Audit Convex apps for performance bottlenecks across reads, writes, and subscriptions.

Updated Mar 19, 2026

Search Tags:#performance #optimization #audit #convex #hot-path #occ-conflicts #subscription-cost

Ready to run

npx skills add https://github.com/just-optimal/optimal-habits-monorepo --skill convex-performance-audit

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: convex-performance-audit
Source: https://github.com/just-optimal/optimal-habits-monorepo/tree/main/packages/db/.agents/skills/convex-performance-audit
Command: npx skills add https://github.com/just-optimal/optimal-habits-monorepo --skill convex-performance-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Diagnose and optimize Convex application performance by focusing on hot path reads, write contention, subscription cost, and function budgets, enabling targeted, safe improvements.

Core Features & Use Cases

Scan for hot-path reads and data read amplification
Detect OCC conflicts and mutation retries to reduce waste
Recommend migration-safe, incremental fixes and strategy choices

Quick Start

Run a targeted Convex performance audit starting from the strongest signal and apply the smallest high-impact fix first.

Frequently Asked Questions about convex-performance-audit

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

FAQPage Schema

How do I audit my Convex app for high bytes read and slow page performance?▼

Audit your Convex app by scoping to one concrete user flow, then scan for hot-path reads and data read amplification to identify performance bottlenecks. Start from the strongest signal and apply the smallest high-impact fix first.

Why does my Convex app have frequent mutation retries and OCC conflicts?▼

OCC conflicts and mutation retries occur due to write contention in your Convex app. Detect these performance bottlenecks by auditing function budgets and consulting occ-conflicts references to apply migration-safe fixes.

What is the best way to reduce elevated subscription costs in a Convex application?▼

Reduce elevated subscription costs by auditing your Convex app to identify subscription bottlenecks. Consult subscription-cost references to apply targeted, incremental fixes that optimize function budgets and data reads.

Can I apply incremental performance fixes to a Convex app without breaking existing migrations?▼

Yes, you can apply migration-safe fixes to your Convex app. The audit recommends incremental improvements and strategy choices across reads, writes, and subscriptions to ensure safe performance optimization.

How do I scope a Convex performance audit when my application has multiple slow user flows?▼

Scope your Convex performance audit to one concrete user flow at a time. Focus on hot-path reads, write contention, subscription cost, and function budgets to systematically address each slow page symptom.