convex-functions

Validate arguments and structure queries, mutations, actions, and HTTP actions for Convex backends.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/EricJamesCrow/smartpockets --skill convex-functions-ericjamescrow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-functions
Source: https://github.com/EricJamesCrow/smartpockets/tree/main/.claude/skills/convex-functions
Command: npx skills add https://github.com/EricJamesCrow/smartpockets --skill convex-functions-ericjamescrow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convex Functions provides a structured approach for building robust Convex backends with validated arguments and safe runtime patterns across queries, mutations, actions, and HTTP actions.

Core Features & Use Cases

  • Consistent argument validation for queries, mutations, actions, and HTTP actions.
  • Clear separation of public, internal, and API surfaces with proper security and runtime handling.
  • Best practices for production-grade Convex backends, including linting and governance.

Quick Start

Create a simple query with argument validation and a typed return to see how Convex functions are wired.

Frequently Asked Questions about convex-functions

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

FAQPage Schema
How do I validate arguments in Convex functions for queries and mutations?

To validate arguments in Convex functions, you must use explicit validators for all arguments and return types across queries and mutations. This ensures consistent validation, safe runtime behavior, and strict function boundaries.

What is the difference between Convex actions and HTTP actions for backend routing?

Convex actions and HTTP actions differ in their access surfaces. Actions handle internal runtime logic, while HTTP actions expose external API endpoints, both requiring clear function type usage and tiered access control for secure boundaries.

How do I set up tiered access control for Convex mutations and queries?

Setting up tiered access control for Convex mutations and queries requires a clear separation of public, internal, and API surfaces. This ensures proper security and runtime handling across all function types.

Does this approach to Convex functions support production-grade backend governance?

Yes, this approach supports production-grade Convex backends by applying best practices for consistent validation, error handling, and linting. It ensures secure function boundaries and safe runtime behavior for development teams.

Why do my Convex HTTP actions fail without explicit return validators?

Convex HTTP actions fail without explicit return validators because strict validation is required for safe runtime behavior. Applying explicit argument and return validators ensures consistent error handling and secure function boundaries.

Can I use Convex functions for end-to-end data tasks without strict validation?

Using Convex functions for end-to-end data tasks without strict validation is not recommended. Explicit validators for arguments and returns are required to ensure safe runtime behavior and robust backend operations.