convex-performance-audit

Diagnose Convex hot path reads, OCC conflicts, and subscription costs.

99|6|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/vvedantb/eva --skill convex-performance-audit-vvedantb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-performance-audit
Source: https://github.com/vvedantb/eva/tree/main/.agents/skills/convex-performance-audit
Command: npx skills add https://github.com/vvedantb/eva --skill convex-performance-audit-vvedantb

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Diagnose Convex application performance and identify hot path reads, OCC conflicts, and subscription costs.

Core Features & Use Cases

  • Diagnose hot path reads, write contention, subscription cost, and function budgets.
  • Provide guided fixes using references and best practices to reduce reads, writes, and reactive invalidation.
  • Escalate to migration-safe patterns when needed, coordinating with migration helper workflows.

Quick Start

Run a Convex performance audit on your project and apply the strongest recommended 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 my Convex app for performance issues like hot path reads?

A Convex performance audit diagnoses hot path reads, subscription costs, and OCC conflicts by tracing reads and writes across a specific user flow. It evaluates function budgets and applies built-in reference fixes to reduce reactive invalidation.

What's the best way to reduce subscription costs in my Convex application?

Reduce Convex subscription costs by tracing reactive invalidation across user flows and applying guided best practices. The audit identifies excessive subscriptions and implements fixes following a reference-guided order to minimize reactive updates.

Why does my Convex app experience write contention and OCC conflicts?

Convex apps experience OCC conflicts and write contention when concurrent operations compete for the same documents. The performance audit identifies these conflicts by tracing write paths across user flows and applies best practice fixes to reduce contention.

Can I use this audit to evaluate function budgets for specific user flows?

Yes, the Convex performance audit evaluates function budgets by enforcing one concrete user flow as the audit scope. It traces all reads and writes across that path to ensure operations stay within optimal resource limits.

When should I escalate to migration-safe patterns during a Convex performance audit?

You should escalate to migration-safe patterns during a Convex performance audit when standard reference-guided fixes cannot resolve hot path reads or write contention. This coordinates with migration helper workflows to safely restructure problematic data patterns.