convex-performance-audit

Audit Convex applications to diagnose and resolve performance bottlenecks.

Updated Apr 22, 2026
One-click install
npx skills add https://github.com/wixels/sab-colour-profile --skill convex-performance-audit-wixels
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-performance-audit
Source: https://github.com/wixels/sab-colour-profile/tree/main/packages/backend/.agents/skills/convex-performance-audit
Command: npx skills add https://github.com/wixels/sab-colour-profile --skill convex-performance-audit-wixels

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the guesswork of debugging slow, expensive Convex applications by providing a structured workflow to diagnose performance bottlenecks including high read amplification, OCC write contention, excessive subscription costs, and function execution limit errors.

Core Features & Use Cases

  • Structured Performance Audit Workflow: Step-by-step process to scope problems, trace full read/write paths, and apply targeted fixes for specific performance issue classes.
  • Reference Guides for Common Issues: Dedicated guides for hot-path read optimization, OCC conflict resolution, subscription cost reduction, and function budget management.
  • Guardrails and Escalation Rules: Prevents unnecessary large-scale refactors for small deployments, and provides migration-safe rollout guidance for invasive cross-cutting fixes.
  • Use Case: If your Convex app has slow page loads, high cloud costs from excessive reads, frequent mutation retries, or functions hitting execution limits, use this Skill to identify the root cause and implement the smallest effective fix.

Quick Start

Use the convex-performance-audit skill to diagnose and resolve the performance issues you are experiencing with your Convex application, starting with the strongest available signal from your deployment insights or codebase.

Frequently Asked Questions about convex-performance-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix high read amplification and slow page loads in my Convex app?

Convex performance audits trace full read/write paths to identify high read amplification and apply targeted optimizations. This structured approach reduces excessive database reads and resolves slow page loads without requiring unnecessary large-scale refactors.

Why does my Convex function keep hitting execution limits and timing out?

Convex function execution limits are hit when processing exceeds runtime budgets. A performance audit identifies slow functions and provides guardrails to implement budget management and targeted fixes, preventing timeout errors.

How do I reduce excessive subscription costs in my Convex deployment?

Reducing subscription costs in Convex involves auditing reactive data flows to minimize unnecessary UI updates. The performance audit workflow provides reference guides to cut subscription overhead and lower cloud costs.

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

Resolving Convex OCC write contention requires auditing mutation retries to identify conflicting write paths. The performance audit provides conflict resolution guides to apply targeted fixes and stop frequent mutation retries.

Can I audit Convex backend performance without runtime deployment insights?

You can audit Convex backend performance using code-level analysis when runtime signals are unavailable. The audit workflow applies guardrails to identify bottlenecks like read amplification directly from the codebase.

When should I avoid large-scale refactors for Convex performance optimization?

Avoid large-scale refactors for Convex performance optimization in small-scale or low-traffic deployments. The audit provides guardrails and escalation rules to implement the smallest effective fix instead of invasive cross-cutting changes.