convex-core

Define strict schemas, validators, and indexes for TypeScript-based Convex projects.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/IgorWarzocha/realtime-dashboard-analytics-demo --skill convex-core
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-core
Source: https://github.com/IgorWarzocha/realtime-dashboard-analytics-demo/tree/main/.opencode/skill/convex-core
Command: npx skills add https://github.com/IgorWarzocha/realtime-dashboard-analytics-demo --skill convex-core

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill consolidates core Convex modeling patterns to help you define strict schemas, validators, and indexed queries for reliable data access and function authoring.

Core Features & Use Cases

  • Schema design and table definitions: Use defineSchema/defineTable in convex/schema.ts with v.* validators to model data with automatic system fields.
  • Validation-driven development: Build precise args/returns validators for queries, mutations, and actions to ensure type-safe, secure logic.
  • Performance and indexing guidance: Create and tune indexes to optimize reads, with awareness of pagination and system tables.

Quick Start

Inspect the core concepts and implement a basic Convex schema: define a table with a couple of fields using v.* validators, and add a simple index to demonstrate withIndex usage.

Frequently Asked Questions about convex-core

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

FAQPage Schema
How do I define a Convex schema with strict TypeScript validators?

To define a Convex schema with strict TypeScript validators, use `defineSchema` and `defineTable` in `convex/schema.ts` alongside `v.*` validators to model data with automatic system fields and typed IDs.

How do I create type-safe queries and mutations in Convex?

Create type-safe Convex queries and mutations by defining precise `args` and `returns` validators using `v.*` primitives, ensuring secure logic and reliable validation-driven development for your functions.

What is the best way to optimize Convex database reads with indexes?

Optimize Convex database reads by creating and tuning table indexes, utilizing the `withIndex` query method to ensure predictable performance and scalable data access patterns.

Can I use Convex actions with typed arguments and returns?

Yes, you can build Convex actions with typed arguments and returns by applying precise `v.*` validators to your function definitions, ensuring type-safe and secure logic execution.

Do I need to manually add system fields when defining Convex tables?

No, you do not need to manually add system fields when defining Convex tables; using `defineTable` with `v.*` validators automatically includes system fields while modeling your data schema.

How does pagination work with indexed Convex queries?

Pagination works with indexed Convex queries by combining tuned indexes with query cursor logic, allowing you to manage large datasets efficiently and maintain predictable read performance.