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.