convex-performance-audit

Diagnose and remediate Convex performance bottlenecks from insights or code symptoms.

5|Updated Apr 29, 2020
One-click install
npx skills add https://github.com/vanities/bitchan --skill convex-performance-audit-vanities
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-performance-audit
Source: https://github.com/vanities/bitchan/tree/main/web/.agents/skills/convex-performance-audit
Command: npx skills add https://github.com/vanities/bitchan --skill convex-performance-audit-vanities

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Convex Performance Audit helps you diagnose and fix slow or expensive Convex behavior by identifying the specific performance problem class (read amplification, OCC conflicts, subscription cost, or function budget issues) and applying targeted remedies.

Core Features & Use Cases

  • Signal-driven performance triage: Uses the strongest available evidence from deployment health insights or npx convex insights --details, falling back to a code audit when needed.
  • Problem-class specific remediation: Routes symptoms to the matching guidance for hot paths, OCC conflicts, subscription cost, or execution/function limits.
  • Correctness-safe scope and verification: Traces one concrete user flow end-to-end (reads and writes), audits sibling functions touching the same tables, and verifies result parity after changes.

Quick Start

Ask the assistant to audit your Convex project by running npx convex insights --details and then tracing the slow feature’s full read/write set to propose the smallest high-impact fix within the relevant reference.

Frequently Asked Questions about convex-performance-audit

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

FAQPage Schema
Why does my Convex app have slow reads and high mutation retries?

Slow Convex reads and excessive mutation retries often stem from read amplification or OCC conflicts. Diagnose these performance bottlenecks by tracing full read/write sets and mapping symptoms to specific remediation rules for hot paths.

How do I audit Convex subscription overhead and query limits?

Audit Convex subscription overhead and query limits by running `npx convex insights --details` to gather deployment health signals. Route the identified symptoms to matching guidance for subscription cost or function execution budget issues.

What is the best way to fix high bytes and doc reads in Convex?

Fix high bytes and doc reads in Convex by applying signal-driven performance triage to identify read amplification. Trace one concrete user flow end-to-end and propose the smallest high-impact fix within the relevant reference rules.

Can I trace specific user flows to fix Convex function budget errors?

You can trace specific user flows to fix Convex function budget errors by auditing sibling functions touching the same tables. Verify no regressions occur after changes by checking result parity and confirming execution limits are resolved.

How do I diagnose Convex OCC conflicts without deployment insights?

Diagnose Convex OCC conflicts without deployment insights by performing a targeted code audit. Look for code symptoms like high mutation retries or high subscription counts and map them to specific reference rules for remediation.