convex-backend

convex-backend is a skill for Claude Code from CloudAI-X/claude-workflow-v2. It costs 58 tokens per session (963 once invoked), scanned A, original, MIT.

A set of guidelines for building Convex backends in TypeScript. Convex is a backend platform that provides database functions, real-time data updates, file storage, and scheduled work.

In plain words
What is it for?
Use it when writing Convex queries, mutations, actions, schemas, validators, real-time subscriptions, scheduled functions, or file-storage code.
Why use it?
It helps keep database schemas, data validation, queries, writes, server actions, and subscriptions consistent with Convex’s required patterns.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions AGENTS.md.

Part of the claude-workflow-v2 plugin — 14 skills, 26 commands, 7 agents, 6 hooks shipped together

Good fit Use it when writing Convex queries, mutations, actions, schemas, validators, real-time subscriptions, scheduled functions, or file-storage code.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/cloudai-x/claude-workflow-v2/convex-backend
About the project

Project Starter is a workflow plugin that equips coding agents with specialized subagents, reusable skills, commands, hooks, and output styles for software projects. It is for developers who want structured assistance with tasks such as planning, debugging, code review, security, and automation across several coding-agent platforms. Catalogue add-ons are components of its own workflow.

CloudAI-X/claude-workflow-v2 · 1,413 stars · on GitHub

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 CloudAI-X/claude-workflow-v2 --skill convex-backend
Clone the repo
git clone --depth 1 https://github.com/CloudAI-X/claude-workflow-v2

Made for: Claude Code.

Or install claude-workflow-v2, the plugin that ships this one along with the rest of its 14 skills, 26 commands, 7 agents, 6 hooks.

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.

agentmods badge for convex-backend

README.md
[![agentmods](https://agentmods.dev/badge/skills/cloudai-x/claude-workflow-v2/convex-backend.svg)](https://agentmods.dev/skills/cloudai-x/claude-workflow-v2/convex-backend)
Your own site
<a href="https://agentmods.dev/skills/cloudai-x/claude-workflow-v2/convex-backend"><img src="https://agentmods.dev/badge/skills/cloudai-x/claude-workflow-v2/convex-backend.svg" alt="Measured on agentmods" height="20"></a>
Per session 58 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 963 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00058 $0.00963
Opus 5 $0.00029 $0.00481
Sonnet 5 $0.00012 $0.00193
Haiku 4.5 $0.00006 $0.00096

Measured 8d ago against content hash 31215cd5f501, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

convex-backend 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 8d 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.

skills/convex-backend/SKILL.md · 120 lines

How it starts

The opening of the file, as written. The whole thing — 120 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Convex Backend Guidelines

When to Load

  • Trigger: Convex-specific development, writing Convex functions, schemas, queries, mutations, actions, or real-time subscriptions
  • Skip: Project does not use Convex as its backend

Comprehensive guide for building Convex backends with TypeScript. Covers function syntax, validators, schemas, queries, mutations, actions, scheduling, and file storage.

When to Apply

Reference these guidelines when:

  • Writing new Convex functions (queries, mutations, actions)
  • Defining database schemas and validators
  • Implementing real-time data fetching
  • Setting up cron jobs or scheduled functions
  • Working with file storage
  • Designing API structure

Rule Categories

Category Impact Description
Function Syntax CRITICAL New function syntax with args/returns/handler
Validators CRITICAL Type-safe argument and return validation
Schema Design HIGH Table definitions, indexes, system fields
Query Patterns HIGH Efficient data fetching with indexes
Mutation Patterns MEDIUM Database writes, patch vs replace
Action Patterns MEDIUM External API calls, Node.js runtime
Scheduling MEDIUM Crons and delayed function execution
File Storage LOW Blob storage and metadata

Quick Reference

Function Registration

// Public functions (exposed to clients)
import { query, mutation, action } from "./_generated/server";

// Internal functions (only callable from other Convex functions)
import {
  internalQuery,
  internalMutation,
  internalAction,
} from "./_generated/server";

Function Syntax (Always Use This)

export const myFunction = query({
  args: { name: v.string() },
  returns: v.string(),
  handler: async (ctx, args) => {
    return "Hello " + args.name;
  },
});

Read the full file on GitHub · 120 lines

Files

What ships with it

1 file 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.

  1. 8d ago First seen · 120 lines · 58 tokens per session scan A 31215cd5f501

Subscribe to this mod's changes

convex-backend is a skill published in the GitHub repository CloudAI-X/claude-workflow-v2 (1,413 stars, last pushed 14d ago), licensed MIT. It adds 58 tokens to every session and 963 once invoked, about $0.0003 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.

Related

Other skills, from other repositories

cqrs-implementation

Implement Command Query Responsibility Segregation for scalable architectures. Use when separating read and write models, optimizing query performance, or building event-sourced systems.

wshobson/agents · 35 tokens

event-store-design

Design and implement event stores for event-sourced systems. Use when building event sourcing infrastructure, choosing event store technologies, or implementing event persistence patterns.

wshobson/agents · 33 tokens

workflow-orchestration-patterns

Design durable workflows with Temporal for distributed systems. Covers workflow vs activity separation, saga patterns, state management, and determinism constraints. Use when building long-running processes, distributed transactions, or microservice orchestration.

wshobson/agents · 49 tokens

microservices-patterns

Design microservices architectures with service boundaries, event-driven communication, and resilience patterns. Use when building distributed systems, decomposing monoliths, or implementing microservices.

wshobson/agents · 38 tokens

diagnose-backend-bug

Diagnose a bounded backend or multi-service failure from GitHub Issues, Jira, Aone, user-provided exports, logs, traces, responses, stack traces, or job records. Use when a service, API, RPC, worker, queue, CLI, or scheduled job bug needs correlation through the project's existing observability route before repair; do…

QoderAI/better-harness · 87 tokens

api-doc-generator

Generate API documentation from source code, supporting REST APIs, GraphQL, and various documentation formats.

JackyST0/awesome-agent-skills · 23 tokens