convex-performance-audit

Diagnose bottlenecks in Convex apps by analyzing reads, writes, subscriptions, and budgets.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audits Convex applications to identify bottlenecks across hot-path reads, write contention, subscription load, and function budgets, enabling targeted optimizations.

Core Features & Use Cases

  • Diagnose signals from Convex insights, code audits, and runtime telemetry to surface the root cause of slow paths.
  • Map issues to Convex best-practice references (hot-path rules, OCC conflicts, subscription cost, function budget) and propose minimal, safe fixes.
  • Prioritize fixes within a migration-safe workflow, including guardrails and escalation when needed.

Quick Start

Run a performance audit on your Convex app to identify hot-path bottlenecks and generate prioritized fixes.

Frequently Asked Questions about convex-performance-audit

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

FAQPage Schema
How do I identify performance bottlenecks in a Convex application?

Diagnose Convex performance bottlenecks by analyzing hot-path reads, write contention, subscription load, and function budgets using runtime traces. This surfaces root causes of slow paths and high mutation retries to propose targeted fixes.

What causes high mutation retries and OCC conflicts in Convex?

High mutation retries and OCC conflicts in Convex are caused by write contention, where concurrent mutations compete to modify overlapping data. Auditing function budgets and mapping contention signals to best-practice references helps propose minimal, safe fixes.

How do I audit Convex subscription cost and excessive subscription load?

Audit Convex subscription cost by evaluating subscription load and hot-path reads from application flows and runtime telemetry. Mapping these findings to reference-guided remediation workflows diagnoses excessive subscriptions and enables targeted optimizations.

What signals do I need to diagnose slow reads in Convex?

Diagnosing slow reads in Convex requires signals from Convex insights, code audits, and runtime traces. Analyzing these inputs against hot-path rules and function budgets identifies the root cause and maps findings to safe remediation workflows.

Can I fix near-limit function usage in Convex without breaking migrations?

Yes, you can fix near-limit function usage in Convex safely by prioritizing optimizations within a migration-safe workflow. The audit maps function budget issues to reference-guided guardrails and escalation paths to ensure minimal, safe fixes.

What's the best way to resolve write contention in Convex databases?

The best way to resolve Convex write contention is auditing OCC conflicts and hot-path reads via code audits and runtime traces. Mapping these issues to best-practice references provides minimal, targeted fixes within a migration-safe workflow.