convex-performance-audit

Diagnose Convex app performance issues and specify targeted remediation steps.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/birajdotdev/next-clerk-convex-starter --skill convex-performance-audit-birajdotdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-performance-audit
Source: https://github.com/birajdotdev/next-clerk-convex-starter/tree/main/.agents/skills/convex-performance-audit
Command: npx skills add https://github.com/birajdotdev/next-clerk-convex-starter --skill convex-performance-audit-birajdotdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnoses and fixes Convex performance problems across hot-path reads, write contention, subscription cost, and function budgets to keep apps fast and cost-efficient.

Core Features & Use Cases

  • Identify root causes of slow or expensive Convex paths, including high bytes or documents read, OCC conflicts, and excessive reactivity.
  • Provide guided, safe, and non-invasive fixes with guardrails before large migrations, and outline concrete next steps for broader optimization.
  • Document problem classes and recommended fixes in a structured workflow that can be reused across multiple functions or pages.

Quick Start

Run a production-ready Convex performance audit to surface the strongest signal and a concise, high-impact 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 apps for performance bottlenecks?

To audit Convex app performance, diagnose hot-path reads, write contention, subscription overhead, and function-budget hotspots using signal-driven analysis to identify root causes and specify targeted improvements.

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

OCC conflicts in Convex arise from write contention on overlapping documents. Identify these hot-path write bottlenecks using runtime signals, then apply targeted, non-invasive remediation steps with guardrails to reduce contention safely.

How do I reduce subscription cost and excessive reactivity in Convex?

Reduce Convex subscription cost by diagnosing subscription overhead and excessive reactivity through signal-driven analysis of concrete user flows, then applying one targeted improvement per issue to limit unnecessary data fetching.

What is the best way to identify slow or expensive Convex queries?

The best way to identify slow or expensive Convex paths is to analyze high bytes or documents read, OCC conflicts, and excessive reactivity, prioritizing the strongest runtime signal to apply a concise, high-impact fix.

Can I optimize Convex performance without invasive database migrations?

Yes, you can optimize Convex performance non-invasively by applying targeted improvements with guardrails before large migrations, documenting problem classes and recommended fixes in a structured workflow reusable across functions.

When should I run a Convex performance audit on my application?

Run a Convex performance audit when your app experiences slow paths, high read costs, or excessive reactivity. It surfaces the strongest runtime signal and yields actionable remediation steps to keep apps fast and cost-efficient.