convex-return-validators

What problem does it solve?

Convex developers often struggle with knowing when to apply return validators and how to reason about runtime contract enforcement. This skill provides guidance on best practices for using returns validators in Convex functions to improve type safety without adding unnecessary boilerplate.

Core Features & Use Cases

• Clarifies when to use or avoid return validators in queries, mutations, and actions.
• Explains how validators interact with runtime contracts, static codegen, OpenAPI generation, and external data.
• Provides practical examples and decision framework for common Convex development scenarios.

Quick Start

Decide if a returns validator is needed for a Convex function and implement it only when runtime contract enforcement is required.