convex-reviewer

Reviews Convex functions for security, auth, validators, and performance anti-patterns.

Updated Sep 17, 2026
One-click install
npx skills add https://github.com/Tehzeeb07/CodeRush --skill convex-reviewer-tehzeeb07
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: convex-reviewer
Source: https://github.com/Tehzeeb07/CodeRush/tree/main/.agents/skills/convex-reviewer
Command: npx skills add https://github.com/Tehzeeb07/CodeRush --skill convex-reviewer-tehzeeb07

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Shipping Convex backend code without a structured review risks unauthenticated public mutations, full table scans, broken reactivity, and missing validators. This Skill applies a Convex-specific checklist to catch these issues before deployment. ## Core Features & Use Cases - Security Audit: Verifies every public function checks ctx.auth.getUserIdentity(), confirms resource ownership before reads/writes, and flags client-provided user IDs and scheduled functions targeting api.* instead of internal.*. - Performance Review: Detects .filter() on database queries, missing indexes on foreign-key fields, Date.now() in query handlers, and unbounded .collect() calls. - Code Quality Checks: Confirms args and returns validators on public functions, no any types, awaited promises, and bounded document arrays. - Use Case: Before merging a pull request that adds new Convex mutations, run this review to get findings grouped by severity (Critical / Important / Suggestion) with explanations and suggested fixes. ## Quick Start Review the code in my convex/ directory for security, performance, and validator issues before I ship it.

Frequently Asked Questions about convex-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review Convex functions for security issues?▼

Run a structured review that verifies every public function calls ctx.auth.getUserIdentity(), checks resource ownership before reads and writes, and never trusts client-provided user IDs. Missing auth checks on public mutations are flagged as Critical since they risk data loss.

What are common Convex performance anti-patterns?▼

The main anti-patterns are using .filter() on database queries (a full table scan requiring withIndex instead), missing indexes on foreign-key fields, calling Date.now() in query handlers which breaks reactivity, and using .collect() on unbounded queries.

Why should scheduled Convex functions target internal instead of api?▼

Scheduled functions should target internal.* functions rather than api.* because public API functions are exposed to clients. Scheduling to api.* endpoints creates an attack surface, so the review flags this pattern as Important.

Does Convex require args and returns validators on functions?▼

Yes, every public Convex function should define args and returns validators. Missing validators are flagged as Important findings because they weaken type safety and allow unvalidated data into your backend.

When should I run a Convex code review?▼

Run the review before shipping or merging changes to your convex/ directory. It produces findings grouped by severity (Critical, Important, Suggestion) with explanations of why each issue matters and a suggested fix.