convex-performance-audit

Diagnose performance bottlenecks in Convex applications by analyzing read amplification, write contention, and subscription costs.

Updated May 5, 2026
One-click install
npx skills add https://github.com/DominikKoniarz/vendo --skill convex-performance-audit-dominikkoniarz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-performance-audit
Source: https://github.com/DominikKoniarz/vendo/tree/main/packages/backend/.agents/skills/convex-performance-audit
Command: npx skills add https://github.com/DominikKoniarz/vendo --skill convex-performance-audit-dominikkoniarz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill addresses performance bottlenecks in Convex applications, including high read amplification, write contention, excessive subscription costs, and function execution limit violations.

Core Features & Use Cases

  • Performance Diagnosis: Analyzes Convex insights to identify hot-path reads, OCC conflicts, and expensive reactive queries.
  • Optimization Strategies: Provides actionable patterns for index usage, document splitting, batching mutations, and implementing digest tables.
  • Use Case: Use this skill when your application experiences slow page loads, frequent OCC conflict errors, or high database read costs, and you need a systematic approach to refactor your Convex functions for better efficiency.

Quick Start

Run the convex performance audit skill to analyze the current deployment insights and identify the primary bottleneck in the application.

Frequently Asked Questions about convex-performance-audit

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

FAQPage Schema
How do I reduce high database read costs and latency in my Convex application?

To reduce high database read costs and latency in your Convex application, you need to audit read amplification and optimize reactive query patterns. This involves analyzing deployment insights to identify hot-path reads and applying efficient database indexing strategies to minimize unnecessary data fetching.

Why does my Convex backend experience frequent OCC conflict errors?

OCC conflict errors in a Convex backend occur due to write contention when multiple transactions attempt to modify the same documents simultaneously. Resolving this requires diagnosing contention points and implementing mutation batching or document splitting to reduce transaction overlaps.

How do I optimize expensive reactive queries and subscription costs in Convex?

Optimizing expensive reactive queries and subscription costs in Convex requires analyzing subscription behavior to eliminate unnecessary re-renders. You can implement digest tables and refactor reactive query management to limit the frequency and scope of database updates pushed to clients.

What is the best way to handle function execution limit violations in Convex?

The best way to handle function execution limit violations in Convex is to diagnose performance bottlenecks causing timeouts. By analyzing read amplification and splitting large documents, you can refactor functions to process smaller payloads and stay within transaction limits.

Can I audit a production-grade Convex backend for scalability issues?

Yes, you can audit a production-grade Convex backend for scalability issues by analyzing current deployment insights. This systematic approach identifies primary bottlenecks like excessive subscription costs or write contention and provides actionable optimization patterns for efficient resource usage.