convex-performance-audit

Audit Convex apps for performance bottlenecks across reads, subscriptions, and writes.

9.3k|1.4k|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/openclaw/clawhub --skill convex-performance-audit-openclaw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-performance-audit
Source: https://github.com/openclaw/clawhub/tree/main/.agents/skills/convex-performance-audit
Command: npx skills add https://github.com/openclaw/clawhub --skill convex-performance-audit-openclaw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits Convex performance to identify bottlenecks across reads, subscriptions, and writes, enabling targeted optimizations.

Core Features & Use Cases

  • Assess hot-path reads and write contention to reduce unnecessary reads and invalidations.
  • Recommend precise optimizations such as indexing, denormalization, or splitting hot documents.
  • Provide actionable guidance for teams to improve Convex app performance in production.

Quick Start

Run a Convex performance audit on your project to surface the top bottleneck and 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 find performance bottlenecks in my Convex app?

To find Convex performance bottlenecks, you need to audit code paths, database reads/writes, and trigger patterns to identify hot-path issues and propose fixes like indexing or denormalization.

What causes high read amplification and write contention in Convex?

High read amplification and write contention in Convex are caused by inefficient hot-path reads and overlapping document triggers. Auditing subscription and write patterns surfaces these conflicts for targeted optimization.

How do I optimize slow UI paths caused by Convex subscriptions?

Optimize slow UI paths in Convex by assessing hot-path reads to reduce unnecessary database reads and subscription invalidations, then applying fixes like indexing or splitting hot documents.

What is the best way to reduce unnecessary reads in Convex queries?

The best way to reduce unnecessary reads in Convex is to audit query code paths to detect read amplification, then apply precise optimizations such as indexing, denormalization, or splitting hot documents.

When should I split hot documents to fix Convex write contention?

You should split hot documents to fix Convex write contention when an audit reveals OCC conflicts and high write frequency on specific documents, which splitting distributes to reduce contention.

Can I use a Convex performance audit for production apps?

Yes, you can use a Convex performance audit for production apps. It analyzes production insights, read/write contention, and trigger patterns to provide actionable guidance and guardrails for teams.