Description
convex-advisor is an agent skill that reads a live Convex deployment's health insights and turns them into findings about performance and cost. Static code review can only guess at what is slow, but the deployment records what actually happened over the last 72 hours. The official Convex MCP provides an insights tool with typed health events for each function, covering hard read limits for documents and bytes, approaching-threshold warnings, and write contention events, where a write failed permanently or was retried. Each event carries evidence, such as the table name, bytes and documents read, and the document involved in a conflict with its retry count. The skill takes each event and reads the flagged function's code to find the root cause, then reports findings backed by that evidence, each with a suggested fix. It is part of the get-convex agent-skills repository and is added to a compatible agent with the skills command. Because it depends on the Convex MCP insights tool, it needs that connection to be set up in the agent. It suits developers who already run a Convex app in production and want advice based on real usage rather than a code guess.…
Highlights
- Reads 72-hour deployment health insights
- Covers read limits and write contention
- Root-causes each event in the function code
- Reports evidence-backed fixes
Ratings & Reviews
No ratings yet
Be the first to rate convex-advisor.
People also visit
convex-sentinel
Set up Sentinel production error capture in your own Convex deployment
convex-advisor FAQ
What does convex-advisor do?
It reads a live Convex deployment's 72-hour insights and reports evidence-backed performance and cost findings with fixes.
What events does it read?
Document and byte read limits and thresholds, and write contention events such as permanent failures and retries.
How does it find the cause?
It reads the code of the flagged function to root-cause each event.
What does it need?
The official Convex MCP insights tool connected to the agent.
How do I install it?
Run: npx skills add https://github.com/get-convex/agent-skills --skill convex-advisor
What are the best convex-advisor alternatives?
Popular alternatives to convex-advisor include convex-cost, convex-reviewer and convex-optimize. See all convex-advisor alternatives