convex-performance-audit

Audit Convex applications for slow features, OCC conflicts, and read amplification.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive audit of Convex applications to identify and resolve performance bottlenecks, improving read, write, and subscription efficiency.

Core Features & Use Cases

  • Performance Audit: Identifies slow features, insights findings, OCC conflicts, and read amplification issues.
  • Problem Class Identification: Categorizes performance issues into specific problem classes like hot paths, OCC conflicts, and subscription costs.
  • Reference Guides: Offers detailed reference guides for each problem class, including best practices and code examples.
  • Workflow Guidance: Provides a structured workflow for diagnosing and fixing performance problems, including signal gathering, problem scoping, and verification.
  • Use Case: Use this Skill to analyze a Convex application experiencing slow query performance, and it will guide you through the process of identifying the root cause and applying appropriate fixes.

Quick Start

Use the convex-performance-audit skill to diagnose and fix performance issues in your Convex application. Start by gathering signals from insights or code audits, then follow the structured workflow provided in the Skill.

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 slow Convex queries causing performance bottlenecks?

To identify slow Convex queries, gather signals from application insights or code audits, then categorize the findings into specific problem classes like hot paths, OCC conflicts, and subscription costs for targeted resolution.

What is read amplification in Convex and how does it affect reactive query performance?

Read amplification in Convex occurs when reactive queries inefficiently fetch excessive data, increasing subscription costs and degrading performance; auditing identifies these issues to improve read, write, and subscription efficiency.

How do I diagnose and fix OCC conflicts in my Convex application?

Diagnose and fix OCC conflicts by following a structured workflow that includes signal gathering, problem scoping, and verification, utilizing detailed reference guides with best practices and code examples for resolution.

Can I use a performance audit for Convex applications with occlusion conflicts?

Yes, a performance audit for Convex applications identifies occlusion conflicts alongside other issues like read amplification, categorizing them into distinct problem classes with targeted reference guides for resolution.

What do I need to know to optimize Convex application performance effectively?

To optimize Convex application performance effectively, you need Convex application context and knowledge of Convex features and limitations to properly diagnose problems and apply appropriate fixes using the structured workflow.