convex-performance-audit

Diagnose Convex application performance issues across reads, writes, and subscriptions.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/tacticus-tools/tp2-reset --skill convex-performance-audit-tacticus-tools
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: convex-performance-audit
Source: https://github.com/tacticus-tools/tp2-reset/tree/main/.agents/skills/convex-performance-audit
Command: npx skills add https://github.com/tacticus-tools/tp2-reset --skill convex-performance-audit-tacticus-tools

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audits Convex application performance, diagnosing slow or expensive features across hot-path reads, write contention, subscription cost, and function limits to reduce latency and resource waste.

Core Features & Use Cases

  • End-to-end performance audit: identifies strongest signals from Convex insights and code audits to prioritize fixes.
  • Guided, migration-safe fixes: points to specific references like hot-path rules, OCC conflicts, subscription-cost patterns to apply safe changes.
  • Scope-first approach: focuses on a single concrete user flow to minimize risk and surface sibling patterns for review.

Quick Start

Run a performance audit on your Convex project to surface the strongest signal and a minimal fix.

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 Convex performance to reduce high bytes and documents read?▼

To audit Convex performance, you trace read and write sets on hot-path reads to identify costly queries. This process surfaces the strongest signals from Convex insights, guiding migration-safe fixes that reduce latency and resource waste.

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

OCC conflicts and mutation retries in Convex occur due to write contention. Auditing write sets identifies problem classes where concurrent mutations collide, guiding safe, migration-friendly fixes to resolve the contention.

How do I optimize Convex subscription cost when UI updates are expensive?▼

You optimize Convex subscription cost by applying subscription-cost patterns identified during a performance audit. Tracing subscription behavior isolates expensive UI updates, enabling migration-safe fixes that lower resource consumption.

When do I need a performance audit for my Convex application?▼

You need a Convex performance audit when Convex insights report high bytes or documents read, OCC conflicts, mutation retries, or costly subscriptions. An audit identifies problem classes and traces read/write sets to guide fixes.

What is the best way to fix Convex hot-path reads without breaking existing features?▼

The best way to fix Convex hot-path reads safely is using a scope-first approach. This focuses on a single concrete user flow to minimize risk, applying hot-path rules and migration-friendly fixes from provided references.

Are there limitations to optimizing Convex function limits and write contention?▼

Optimizing Convex function limits and write contention requires identifying problem classes and tracing read/write sets. Fixes are guided by specific references for OCC conflicts and hot-path rules to ensure migration-safe changes.