convex-performance-audit

Audit Convex reads, subscriptions, OCC conflicts, and function budgets.

3|Updated May 23, 2026
One-click install
npx skills add https://github.com/waynesutton/finder9 --skill convex-performance-audit-waynesutton
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-performance-audit
Source: https://github.com/waynesutton/finder9/tree/main/.agents/skills/convex-performance-audit
Command: npx skills add https://github.com/waynesutton/finder9 --skill convex-performance-audit-waynesutton

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audits Convex performance for reads, subscriptions, write contention, and function limits. Use for slow features, insights findings, OCC conflicts, or read amplification.

Core Features & Use Cases

  • Diagnoses hot-path read and write patterns, OCC conflicts, and function budget overruns
  • Recommends targeted optimizations (indexing, denormalization, digest tables, scheduling) to reduce waste
  • Guides production-grade performance tuning, capacity planning, and observability

Quick Start

Run a Convex performance audit against your project to identify top bottlenecks and recommended fixes.

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 read amplification and slow subscriptions?

To audit Convex read amplification and slow subscriptions, trace hot-path reads, identify problem classes, and apply targeted optimizations like indexing or denormalization to reduce database waste. The audit workflow gathers performance signals to pinpoint bottlenecks.

Why does my Convex app keep throwing OCC conflicts on heavy write paths?

OCC conflicts in Convex occur when concurrent writes contend on the same documents. An audit traces write contention patterns, identifies sibling conflicts within function budgets, and recommends scheduling or digest tables to reduce write contention overhead.

What's the best way to reduce elevated database read costs in Convex?

To reduce elevated database read costs in Convex, audit your reads to find hot-path waste, then apply optimizations such as indexing, denormalization, and digest tables. This targeted approach eliminates unnecessary read operations and lowers subscription overhead.

How do I fix Convex function budget overruns on slow pages?

Fixing Convex function budget overruns involves auditing function limits, tracing hot-path reads and writes, and applying capacity planning. The audit identifies where operations exceed budgets and recommends targeted optimizations to bring them within acceptable limits.

When should I use denormalization or digest tables to optimize Convex performance?

Use denormalization or digest tables in Convex when auditing reveals heavy read/write paths and read amplification. These optimizations reduce waste by minimizing repeated reads, resolving sibling patterns, and lowering overall subscription costs for production-grade performance.

Can I use a Convex performance audit for capacity planning and observability?

Yes, a Convex performance audit supports capacity planning and observability by diagnosing function budgets, write contention, and read patterns. It enforces a workflow to gather signals, verify results, and guide production-grade performance tuning for elevated operations.