convex-performance-audit

Audit Convex applications for hot-path reads, write contention, subscription cost, and function budgets.

Updated Feb 25, 2026
One-click install
npx skills add https://github.com/ludicroushq/vertex --skill convex-performance-audit-ludicroushq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-performance-audit
Source: https://github.com/ludicroushq/vertex/tree/main/.agents/skills/convex-performance-audit
Command: npx skills add https://github.com/ludicroushq/vertex --skill convex-performance-audit-ludicroushq

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

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

Core Features & Use Cases

  • Identify the strongest performance signal and problem class from Convex Insights.
  • Map symptoms to reference patterns in references/hot-path-rules.md, references/occ-conflicts.md, references/subscription-cost.md, and references/function-budget.md.
  • Propose scoped, migration-safe fixes and verify outcomes across related functions.

Quick Start

Run a Convex performance audit on your project to identify hot-path bottlenecks and start with the smallest 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 my Convex application for performance bottlenecks?

To audit Convex applications for performance bottlenecks, gather signals from Convex Insights to identify slow features, high document reads, or excessive subscriptions. Map these symptoms to concrete user flows and reference patterns for targeted optimizations.

Why am I getting OCC conflicts in my Convex app and how do I fix them?

OCC conflicts in Convex arise from concurrent write contention on the same documents. Auditing maps these write contention symptoms against concurrency reference patterns to propose migration-safe fixes and validate outcomes across sibling functions.

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

Reducing subscription cost in Convex involves identifying excessive subscriptions and high document read counts. Mapping these symptoms to subscription-cost references enables scoped, minimal-impact optimizations.

What is the best way to optimize Convex functions hitting execution limits?

Optimizing Convex functions near execution or transaction limits requires mapping their symptoms to function-budget rules. This process isolates the problem class from Insights and proposes migration-safe fixes for the specific endpoint.

Can I scope a Convex performance audit to a single user flow instead of the whole app?

Yes, you can scope a Convex performance audit to a single concrete user flow. This approach targets hot-path reads and write contention within that specific endpoint, enabling minimal-impact optimizations and validating fixes across related sibling functions.