convex-performance-audit — Skills

What it does

A Convex page or feature feels slow or expensive

npx convex insights --details reports high bytes read, documents read, or

Low-freshness read paths are using reactivity where point-in-time reads would

OCC conflict errors or excessive mutation retries

High subscription count or slow UI updates

Functions approaching execution or transaction limits

The same performance pattern needs fixing across sibling functions

Requirements & configuration

The same performance pattern needs fixing across sibling functions

hints. Do not require it, and do not treat it as the source of truth.

switching to a new index or denormalized field that needs migration-safe

When correctness depends on handling old and new states during a rollout,

If one read path needs a migration-safe rollout for an unbackfilled field,

Diagnose and resolve Convex performance issues across reads, writes, subscriptions, and function limits.

Source

Repository: https://github.com/get-convex/agent-skills

convex-performance-audit FAQ

What does the convex-performance-audit skill do?

Audits Convex performance for reads, subscriptions, write contention, and function limits. Use for slow features, insights findings, OCC conflicts, or read amplification. A Convex page or feature feels slow or expensive npx convex insights --details reports high bytes read, documents read, or

What does convex-performance-audit require?

The same performance pattern needs fixing across sibling functions hints. Do not require it, and do not treat it as the source of truth. switching to a new index or denormalized field that needs migration-safe When correctness depends on handling old and new states during a rollout, If one read path needs a migration-safe rollout for an unbackfilled field,

How do I install convex-performance-audit?

Run: npx -y skills add https://github.com/get-convex/agent-skills --skill convex-performance-audit --agent claude-code — the source lives at github.com/get-convex/agent-skills.

Maintain convex-performance-audit?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[![convex-performance-audit on getagentictools](https://getagentictools.com/badge/skills/get-convex-agent-skills-convex-performance-audit.svg)](https://getagentictools.com/skills/get-convex-agent-skills-convex-performance-audit?ref=badge)

npx agentictools info skills/get-convex-agent-skills-convex-performance-audit

The second line is the CLI lookup for this page — handy in READMEs and docs.