A general guide for building with Convex, a backend platform that provides server functions, data storage, and realtime subscriptions.

Use it for Convex functions, database schemas, scheduled jobs, file storage, HTTP endpoints, realtime data, AI agents, and security audits.

It helps handle common Convex tasks with the right patterns, including data validation and security checks.

convex — Skill for Codex by J-StaR-Films-Studios

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add J-StaR-Films-Studios/VibeCode-Protocol-Suite --skill convex

Clone the repo

git clone --depth 1 https://github.com/J-StaR-Films-Studios/VibeCode-Protocol-Suite

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/j-star-films-studios/vibecode-protocol-suite/convex/github.svg)](https://agentmods.dev/skills/j-star-films-studios/vibecode-protocol-suite/convex)

Your own site

<a href="https://agentmods.dev/skills/j-star-films-studios/vibecode-protocol-suite/convex"><img src="https://agentmods.dev/badge/skills/j-star-films-studios/vibecode-protocol-suite/convex/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/j-star-films-studios/vibecode-protocol-suite/convex"><img src="https://agentmods.dev/badge/skills/j-star-films-studios/vibecode-protocol-suite/convex.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 47 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 575 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits

NVIDIA SkillSpector pass 7 Sept 2026

How audits are shown

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00047	$0.00575
Opus 5	$0.00023	$0.00287
Sonnet 5	$0.00009	$0.00115
Haiku 4.5	$0.00005	$0.00057

Measured 10d ago against content hash 8043e62293ad, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

convex scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

assets/.agent/skills/convex/SKILL.md · 57 lines

What it actually says

Convex Development Suite

This is the router for Convex development. Open and read the relevant sub-skill file for deep guidance:

Core Development

Area	Sub-Skill Path	Use When
Functions & Queries	`convex-functions/SKILL.md`	Writing queries, mutations, actions
Schema & Types	`convex-schema-validator/SKILL.md`	Defining database schemas and validators
Realtime Subscriptions	`convex-realtime/SKILL.md`	Building reactive subscriptions and caching
HTTP Actions	`convex-http-actions/SKILL.md`	External webhooks and HTTP endpoints

Data & Storage

Area	Sub-Skill Path	Use When
File Storage	`convex-file-storage/SKILL.md`	File uploads, serving, and storage
Migrations	`convex-migrations/SKILL.md`	Schema evolution and data backfills

Advanced Patterns

Area	Sub-Skill Path	Use When
AI Agents	`convex-agents/SKILL.md`	Building AI agents with tool calling
Cron Jobs	`convex-cron-jobs/SKILL.md`	Scheduled background tasks
Component Authoring	`convex-component-authoring/SKILL.md`	Reusable Convex components

Security & Best Practices

Area	Sub-Skill Path	Use When
Security Audit	`convex-security-audit/SKILL.md`	Deep security review
Security Check	`convex-security-check/SKILL.md`	Quick security audit checklist
Best Practices	`convex-best-practices/SKILL.md`	General Convex patterns and guidelines

Quick Start

Check convex-best-practices/SKILL.md for architecture and query patterns.
Read convex-functions/SKILL.md for writing queries, mutations, and actions.
Read convex-schema-validator/SKILL.md for data modeling.
Load specific sub-skills on demand as needed.

Official Documentation

Primary: https://docs.convex.dev
LLM-optimized: https://docs.convex.dev/llms.txt

Files

What ships with it

51 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

10d ago First seen · 57 lines · 47 tokens per session scan A 8043e62293ad

Subscribe to this mod's changes

convex is a skill published in the GitHub repository J-StaR-Films-Studios/VibeCode-Protocol-Suite (24 stars, last pushed 5d ago), licensed ISC. It adds 47 tokens to every session and 575 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Backend and APIs Databases Security Web3 and blockchain ai ai-agents convex prompt-engineering realtime

convex-realtime

Patterns for building reactive apps including subscription management, optimistic updates, cache behavior, and paginated queries with cursor-based loading.

waynesutton/convexskills · 28 tokens

convex-create-component

Designs and builds Convex components with isolated tables, clear boundaries, and app-facing wrappers. Use this skill when creating a new Convex component, extracting reusable backend logic into a component, building a third-party integration that owns its own tables, packaging Convex functionality for reuse, or when…

get-convex/convex-backend · 95 tokens

convex-quickstart

Initializes a new Convex project from scratch or adds Convex to an existing app. Use this skill when starting a new project with Convex, scaffolding with npm create convex@latest, adding Convex to an existing React, Next.js, Vue, Svelte, or other frontend, wiring up ConvexProvider, configuring environment variables…

get-convex/convex-backend · 108 tokens

convex-migration-helper

Plans and executes safe Convex schema and data migrations using the widen-migrate-narrow workflow and the @convex-dev/migrations component. Use this skill when a deployment fails schema validation, existing documents need backfilling, fields need adding or removing or changing type, tables need splitting or merging…

get-convex/convex-backend · 102 tokens

convex-performance-audit

Audits and optimizes Convex application performance across hot-path reads, write contention, subscription cost, and function limits. Use this skill when a Convex feature is slow or expensive, npx convex insights shows high bytes or documents read, OCC conflict errors or mutation retries appear, subscriptions or UI…

get-convex/convex-backend · 97 tokens

convex-setup-auth

Sets up Convex authentication with user management, identity mapping, and access control. Use this skill when adding login or signup to a Convex app, configuring Convex Auth, Clerk, WorkOS AuthKit, Auth0, or custom JWT providers, wiring auth.config.ts, protecting queries and mutations with ctx.auth.getUserIdentity()…

get-convex/convex-backend · 105 tokens