convex-performance-audit

Diagnose and resolve performance issues in Convex applications.

3|10|Updated Dec 18, 2025
One-click install
npx skills add https://github.com/wigxel/community-app --skill convex-performance-audit-wigxel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-performance-audit
Source: https://github.com/wigxel/community-app/tree/main/.agents/skills/convex-performance-audit
Command: npx skills add https://github.com/wigxel/community-app --skill convex-performance-audit-wigxel

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill addresses performance bottlenecks in Convex applications, such as slow page loads, high database costs, and transaction contention, by providing a structured diagnostic and remediation framework.

Core Features & Use Cases

  • Performance Diagnostics: Analyzes read amplification, subscription costs, and OCC conflicts using Convex insights and code patterns.
  • Remediation Strategies: Provides actionable patterns for batching mutations, optimizing indexes, splitting hot documents, and implementing digest tables.
  • Use Case: If a dashboard page is experiencing high latency and frequent OCC conflicts, this Skill guides you through tracing the read/write set, identifying the contention point, and applying the appropriate fix to improve responsiveness.

Quick Start

Use the convex-performance-audit skill to analyze the current performance signals and identify the primary bottleneck in the user flow.

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 page loads and high database costs in my Convex application?

Diagnose slow Convex page loads by analyzing read amplification, subscription overhead, and transaction contention using structured performance insights to identify primary bottlenecks. This process traces the read and write sets to pinpoint exact latency sources.

What is the best way to resolve frequent OCC conflicts and write contention in Convex?

Resolve Convex OCC conflicts by applying remediation strategies like batching mutations, splitting hot documents, and implementing digest tables to reduce transaction overlap. This approach minimizes concurrent write collisions and improves overall responsiveness.

When do I need to optimize indexes and reactive query patterns in a production Convex app?

Optimize Convex indexes and reactive query patterns when your production app faces high latency, frequent transaction conflicts, or elevated data access costs. This ensures high-performance data retrieval and efficient state invalidation.

How do I reduce subscription overhead and read amplification for Convex dashboard pages?

Reduce Convex subscription overhead by auditing reactive query patterns, optimizing database transactions, and adjusting index usage. This minimizes unnecessary data fetching and lowers the computational cost of maintaining live application state.

Can I audit my Convex execution limits and database transactions for scalability issues?

Yes, you can audit Convex execution limits and database transactions to resolve performance bottlenecks and ensure high-performance data access. This evaluates your application's adherence to system constraints under heavy load.

What are the limitations when optimizing Convex apps with heavy read amplification?

Optimizing heavy read amplification in Convex requires careful index management and state invalidation patterns to avoid exceeding execution limits. Complex reactive queries may still face inherent latency constraints if not properly batched or split.