convex-performance-audit

Classify Convex performance bottlenecks and outline prioritized fixes.

1|1|Updated Jan 17, 2026
One-click install
npx skills add https://github.com/LucaDeLeo/ASTN --skill convex-performance-audit-lucadeleo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-performance-audit
Source: https://github.com/LucaDeLeo/ASTN/tree/main/.agents/skills/convex-performance-audit
Command: npx skills add https://github.com/LucaDeLeo/ASTN --skill convex-performance-audit-lucadeleo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audits Convex apps to identify performance bottlenecks across hot path reads, write contention, subscriptions, and function budgets, guiding targeted improvements.

Core Features & Use Cases

  • Structured problem classification using signals from Convex insights and dashboards
  • Reference-guided fixes for common hot-path patterns and safe migrations
  • End-to-end workflow from problem scoping to verification and rollback considerations
  • Use cases include reducing read amplification, splitting hot documents, and moving work to scheduled tasks

Quick Start

Run a Convex performance audit and follow the strongest signal to begin targeted optimizations.

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 performance bottlenecks in a Convex app?

Classify Convex performance bottlenecks by analyzing dashboard insights and references to pinpoint hot-path reads, OCC conflicts, and subscription costs for targeted fixes.

What causes optimistic concurrency control conflicts in Convex and how can I reduce write contention?

Optimistic concurrency control (OCC) conflicts in Convex stem from write contention on hot documents. Reduce contention by splitting hot documents and moving work to scheduled tasks.

How do I optimize Convex hot-path reads and lower subscription costs?

Optimize Convex hot-path reads by reducing read amplification and splitting hot documents. Lower subscription costs by following reference-guided fixes tailored to your app's function budgets.

Does this Convex performance audit provide safe migration guardrails for refactoring functions?

Yes, the Convex performance audit outlines concrete, prioritized fixes with guardrails for safe migrations, ensuring verification checks and rollback considerations are included.

What is the best way to fix Convex function budget overruns and read amplification?

The best way to fix Convex function budget overruns is following a structured audit workflow that scopes read amplification issues and produces an actionable plan with verification checks.