convex-performance-audit

Audit Convex applications for read, subscription, and write contention issues.

Updated Apr 28, 2026
One-click install
npx skills add https://github.com/PBLIZZ/fintek --skill convex-performance-audit-pblizz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-performance-audit
Source: https://github.com/PBLIZZ/fintek/tree/main/.agents/skills/convex-performance-audit
Command: npx skills add https://github.com/PBLIZZ/fintek --skill convex-performance-audit-pblizz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires convex-cli, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill audits Convex applications for performance bottlenecks, ensuring smooth, efficient operation with insights into reads, subscriptions, and write contention.

Core Features & Use Cases

  • Performance Audits: Identifies slow features, insights findings, and OCC conflicts.
  • Read Optimization: Analyzes and suggests improvements for read-heavy paths.
  • Write Contention: Mitigates write contention and mutation retries.
  • Use Case: For instance, if your Convex application is experiencing slow query responses or UI lag, this Skill can diagnose and suggest solutions to enhance performance.

Quick Start

Run the convex-performance-audit skill to start optimizing your Convex application's performance.

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 application for slow query responses and UI lag?

To audit a Convex application for slow query responses and UI lag, run a performance audit that diagnoses read-heavy paths, subscription bottlenecks, and write contention to enhance overall responsiveness.

What causes OCC conflicts and write contention in Convex, and how do I fix them?

OCC conflicts and write contention in Convex are caused by concurrent mutations competing for resources. Performance audits identify these bottlenecks and suggest mitigations like mutation retries to resolve them.

Do I need the Convex CLI to run a performance audit on my application?

Yes, you need the Convex CLI installed to run a performance audit. The CLI is required to generate the insights and execute the diagnostic scripts needed to analyze your application's performance.

How do I reduce read amplification in my Convex database queries?

To reduce read amplification in Convex database queries, analyze read-heavy paths using a performance audit to identify excessive data fetching and receive suggestions for optimizing subscription and read limits.

What are common limitations and function limits I should check during a Convex performance audit?

During a Convex performance audit, check for function limits, read amplification, and subscription bottlenecks. These constraints often limit scalability and cause slow features or OCC conflicts under high load.