convex-performance-audit

The convex-performance-audit skill provides a structured workflow for diagnosing and resolving performance issues in Convex applications, including read amplification, OCC conflicts, subscription costs, and function limits.

79.2K
Installs
6
Use cases
5/10
Quality

Is convex-performance-audit safe to install?

Review the source first

Review the source first: our audit of convex-performance-audit's source files found 2 shell commands, 0 external URLs, file reads and writes (high risk). Every command and URL listed appears verbatim in the skill's source. The skill instructs the agent to execute CLI commands to fetch performance data and requires reading local project files to trace database operations.

How we audit skills: our security review methodology.

Who is this skill for?

Developers working with Convex applications who need to optimize slow features, resolve high-resource usage, or address transaction contention.

What can you do with it?

  • Diagnosing slow or expensive Convex pages and features
  • Analyzing high bytes read, document reads, or OCC conflicts reported by Convex insights
  • Optimizing read paths by replacing reactivity with point-in-time reads
  • Resolving OCC conflict errors and excessive mutation retries
  • Reducing subscription counts and UI update latency
  • Addressing function timeouts and transaction size errors

How good is this skill?

Quality score: 5/10. The skill provides a clear, actionable, and safe workflow for performance auditing. It includes specific guardrails to prevent unnecessary over-engineering.

What does the skill file contain?

SKILL.md
# Convex Performance Audit

Diagnose and fix performance problems in Convex applications, one problem class
at a time.

## When to Use

- A Convex page or feature feels slow or expensive
- `npx convex insights --details` reports high bytes read, documents read, or
  OCC conflicts
- Low-freshness read paths are using reactivity where point-in-time reads would
  do
- 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

## When Not...

Frequently asked questions

What should I do if the Convex CLI is too old to run insights?

The skill suggests running 'npx -y convex@latest insights --details' as a fallback.

How does the skill handle large or invasive refactors?

The skill requires the agent to stop and present options to the user before performing invasive, cross-cutting, or migration-heavy changes.

Does this skill replace the need for official documentation?

No, the skill explicitly directs users to check the official Convex Best Practices page for additional patterns regarding validation, access control, and organization.

Data sourced from get-convex/agent-skills on GitHub. Install counts from skills.sh. The summary and security audit are derived from the skill's source files: every command and URL listed appears verbatim in the source.

Related skills

lark-base

314.2K

Users who need to programmatically interact with Lark Bitable data, automate table management, or perform data analysis within the Lark ecosystem

The lark-base skill provides a command-line interface for managing Lark Bitable (Base) resources, including tables, records, fields, views, forms, dashboards, workflows, and role-based permissions.

highLarkBitablelarksuite

supabase-postgres-best-practices

264.3K

Developers and database administrators working with Postgres and Supabase

This skill provides a structured set of Postgres performance optimization rules and best practices maintained by Supabase. It guides developers in writing, reviewing, and optimizing SQL queries, schema designs, and database configurations.

lowpostgressupabasesupabase

systematic-debugging

173.2K

Software engineers and AI agents tasked with resolving bugs, test failures, or unexpected system behaviors

A structured methodology for debugging technical issues by prioritizing root cause identification over symptom-based patching. It mandates a four-phase process: root cause investigation, pattern analysis, hypothesis testing, and implementation, while providing specific protocols for handling persistent failures and architectural concerns.

highdebuggingtroubleshootingobra

supabase

153.8K

Developers building applications with Supabase who require assistance with database schema design, security policy implementation, CLI operations, and integration troubleshooting

The Supabase skill provides guidance for developing with the Supabase platform, including database management, authentication, RLS policies, CLI usage, and MCP server integration. It emphasizes verifying implementation against current documentation, following security checklists, and using specific CLI commands for schema migrations.

highsupabasepostgresqlsupabase