waynesutton/convexskills
14 skills34.3k installs5.6k starsGitHub
Install
npx skills add https://github.com/waynesutton/convexskillsSkills in this repo
1ConvexUmbrella skill for all Convex development patterns Routes to specific skills like convex-functions convex-realtime convex-agents etc name convex displayName Convex Development description Umbrella skill for all Convex development patterns Routes to specific skills like convex-functions convex-realtime convex-agents etc version 1 0 0 author Convex tags convex backend database realtime Convex Development Skills This is an index skill for Convex development Use specific skills for detailed guidance Core Development Skill Command Use When Functions convex-functions Writing queries mutations actions Schema convex-schema-validator Defining database schemas and validators Realtime convex-realtime Building reactive subscriptions HTTP Actions convex-http-actions Webhooks and HTTP endpoints Data Storage Skill Command Use When File Storage convex-file-storage File uploads serving storage Migrations convex-migrations Schema evolution data backfills Advanced Patterns Skill Command Use When Agents convex-agents Building AI agents with tools Cron Jobs convex-cron-jobs Scheduled background tasks Components convex-component-authoring Reusable Convex packages Security Skill Command Use When Securit.5.7kinstalls2Convex Best PracticesThe convex-best-practices skill Guidelines for building production-ready Convex apps covering function organization, query patterns, validation, TypeScript usage, error handling, and the Zen of Convex design philosophy. Build production-ready Convex applications by following established patterns for function organization, query optimization, validation, TypeScript usage, and error handling. All patterns in this skill comply with @convex-dev/eslint-plugin. Install it for build-time validation: ``bash npm i @convex-dev/eslint-plugin --save-dev `` ```js // eslint.config.js import { defineConfig } from "eslint/config"; import convexPlugin from "@convex-dev/eslint-plugin"; js // eslint.config.js import { defineConfig } from "eslint/config"; import convexPlugin from "@convex-dev/eslint-plugin"; export default defineConfig([ ...convexPlugin.configs.recommended, ]); Rule What it enforces ----------------------------------- --------------------------------- no-old-registered-function-syntax Object syntax with handler require-argument-validators args: {} on all functions explicit-table-ids Table name in db operations import-wrong-runtime No Node imports in Convex runtime Before implementing.3.5kinstalls3Convex FunctionsConvex Functions teaches the four Convex server function types with eslint-compliant object syntax, mandatory argument validators, and explicit table names in database operations. Queries are reactive, cached, and read-only with index-backed ctx.db.query patterns and typed returns unions. Mutations are transactional read-write handlers that validate related records and throw ConvexError for domain failures before insert, patch, or delete. Actions run in Node with external API access via runQuery and runMutation but no direct database access, illustrated with Stripe payment intent creation. HTTP actions expose webhook endpoints with httpAction, path routing, and JSON body parsing that delegate to internal mutations. Internal functions use internalQuery, internalMutation, and internalAction for private server-only calls. The skill documents scheduler usage, pagination with paginationOptsValidator, and runtime considerations including query consistency, mutation atomicity, and action side effects. All examples follow convex-dev eslint-plugin rules requiring handler properties, args validators, and returns validators on every exported function.2.8kinstalls4Convex Schema Validatorconvex-schema-validator is a Convex agent skill for authoring convex/schema.ts with defineSchema, defineTable, and convex/values validators that stay aligned with TypeScript document types. It documents validator mappings from v.string, v.number, v.id, v.optional, v.union, and v.literal through to generated types, plus index design for single-field, compound, and sort-friendly queries. Examples show users and tasks tables with references, priority unions, and channel message indexes such as by_channel and by_channel_and_time. The skill instructs agents to fetch current Convex documentation on schemas, indexes, and types instead of assuming stale API details. Migration guidance covers additive changes, backfills, and safe rollout patterns when evolving live tables. Use it when defining new tables, tightening validation, adding indexes for query paths, or planning schema changes that must not break existing Convex functions and clients.2.7kinstalls5Convex RealtimeThe convex-realtime skill documents patterns for reactive applications using Convex real-time subscriptions, optimistic updates, intelligent caching, and cursor-based pagination. useQuery creates automatic subscriptions that update when relevant data changes, with undefined indicating loading state that must be handled explicitly. Conditional queries use the skip sentinel instead of conditional hook calls. Mutations trigger re-renders when server data changes, and withOptimisticUpdate shows immediate UI feedback for toggles and list inserts before confirmation. Pagination uses paginationOptsValidator on the server and usePaginatedQuery on the client with loadMore, infinite scroll IntersectionObserver examples, and status handling for CanLoadMore, LoadingMore, and Exhausted. Chat application examples pair list queries with send mutations and auto-scroll behavior. Best practices forbid unsanctioned convex deploy or git commands, recommend memoization, appropriate page sizes, and physical testing guidance references official Convex React, optimistic update, and pagination docs.2.6kinstalls6Convex Cron JobsThe convex-cron-jobs skill documents scheduled function patterns for Convex applications including interval scheduling, cron expressions, job monitoring, retry strategies, and long-running task best practices. It directs agents to fetch latest docs from docs.convex.dev scheduling pages before implementing rather than assuming API details. Basic setup uses cronJobs from convex/server with crons.interval for simple recurring tasks and crons.cron for standard five-field cron strings. Examples cover cleanup every hour, daily midnight UTC reports, five-minute external data sync, and thirty-second health checks as the minimum interval. The skill covers cron expression scheduling, internal function references, argument passing, monitoring via the Convex dashboard, failure retries, and patterns for cleanup, data syncing, and automated workflows. Developers use it when adding recurring background tasks to Convex backends without manual external schedulers or separate cron infrastructure.2.5kinstalls7Convex Http ActionsThe convex-http-actions skill documents HTTP endpoint patterns in Convex using httpRouter and httpAction handlers for webhooks, custom APIs, uploads, and external integrations. It instructs agents to fetch current Convex docs before implementing rather than assuming API details. Examples cover basic GET health routes, JSON and form POST parsing, raw byte uploads to Convex storage, pathPrefix dynamic routes, and shared CORS header helpers with OPTIONS preflight. Webhook sections demonstrate Stripe and GitHub signature validation delegating to internal actions with Node runtimes for crypto verification. Authentication patterns show reading Authorization headers inside HTTP actions. Documentation sources link to official Convex HTTP actions, actions overview, auth, and llms.txt for broader context. Teams use this skill when exposing Convex functions as HTTP surfaces for Stripe, GitHub, or custom clients requiring REST-like entry points beyond the default Convex client protocol.2.4kinstalls8Convex Security CheckThe convex-security-check skill provides a quick security audit checklist and code patterns for Convex applications covering authentication, function exposure, validators, row-level access, and secrets handling. Checklist sections require auth provider setup, getUserIdentity checks on sensitive queries, intentional public access, and validated session tokens. Function exposure guidance contrasts public query mutation action surfaces with internalQuery internalMutation internalAction for sensitive operations and HTTP action origin checks. Argument validation insists on explicit args and returns validators, avoiding v.any on sensitive data and correct table ID validators. Row-level patterns verify ownership before update or delete with ConvexError on unauthorized access. Environment variables must live in actions with use node, never in schema or client code, with separate dev and prod keys. Reference implementations show requireAuth helpers, secure listPublicPosts, and internal credit mutations. Agents fetch latest Convex auth and production docs before auditing rather than assuming defaults.2.4kinstalls9Convex File StorageThe convex-file-storage skill documents end-to-end file handling in Convex apps: upload URL generation, client POST upload, database references, serving via ctx.storage.getUrl, action-side blob storage, metadata reads from the _storage system table, and coordinated deletion. It shows generateUploadUrl mutations, a three-step React flow that POSTs with Content-Type, saveFile mutations storing storageId plus file metadata, and queries that join file rows with signed URLs for images, PDF iframes, or downloads. Actions using node can store generated PDFs or fetched image buffers with ctx.storage.store. Metadata access uses ctx.db.system.get on _storage for sha256, size, and contentType instead of deprecated helpers. Pitfalls warn about missing Content-Type headers, orphaned storage without delete, absent client-side type and size validation, and poor large-upload UX. Examples include schema tables, image preview uploaders, and list queries with pagination patterns aligned to current Convex file-storage documentation.2.4kinstalls10Convex MigrationsThe convex-migrations skill teaches safe Convex schema evolution without traditional migration files. Schema changes deploy instantly via npx convex dev while existing documents are not auto-transformed. Add new fields as optional first, update handlers to tolerate undefined, then backfill with paginated internalMutation batches scheduled through ctx.scheduler. After backfill completes, promote fields to required in schema.ts. Removing fields means stopping code usage, making optional if needed, then cleaning data with db.replace to strip deprecated keys. Renames copy to a new optional field with read fallbacks, backfill, then drop the old field. Index additions deploy before queries call withIndex. Type changes follow add-new-field, convert, backfill, remove-old pattern with mapping tables. A migration runner table tracks name, status, processed counts, and completion to avoid duplicate runs. Best practices warn against required fields before backfill, large batch timeouts, and removing fields before code updates. Fetch latest docs from docs.convex.dev before implementing rather than assuming Postgres-style migration commands.2.3kinstalls11Convex Security Auditconvex-security-audit is an agent skill from waynesutton/convexskills that deep security review patterns for authorization logic, data access boundaries, action isolation, rate limiting, and protecting sensitive operations. # Convex Security Audit Comprehensive security review patterns for Convex applications including authorization logic, data access boundaries, action isolation, rate limiting, and protecting sensitive operations. ## Documentation Sources Before implementing, do not assume; fetch the latest documentation: - Primary: https://docs.convex.dev/auth/f Developers invoke convex-security-audit during ship/security work for security tasks. The skill documents triggers, prerequisites, and step-by-step workflows grounded in SKILL.md. Compatible with Claude Code, Cursor, and Codex agent runtimes that load marketplace skills. Review the Security Audits panel on this listing before installing in production environments. Category Security with security vertical focus supports repeatable agent-guided delivery.1.4kinstalls12Convex Agentsconvex-agents is an agent skill from waynesutton/convexskills that building ai agents with the convex agent component including thread management, tool integration, streaming responses, rag patterns, and workflow orchestration. # Convex Agents Build persistent, stateful AI agents with Convex including thread management, tool integration, streaming responses, RAG patterns, and workflow orchestration. ## Documentation Sources Before implementing, do not assume; fetch the latest documentation: - Primary: https://docs.convex.dev/ai - Convex Agent Component: https://www.np Developers invoke convex-agents during build/agent-tooling work for ai & agent building tasks. The skill documents triggers, prerequisites, and step-by-step workflows grounded in SKILL.md. Compatible with Claude Code, Cursor, and Codex agent runtimes that load marketplace skills. Review the Security Audits panel on this listing before installing in production environments. Category AI & Agent Building with ai vertical focus supports repeatable agent-guided delivery.1.4kinstalls13Avoid Feature CreepThe avoid-feature-creep skill is designed for prevent feature creep when building software, apps, and AI-powered products. Use this skill when planning features, reviewing scope, building MVPs, managing backlogs, or when a. Avoid Feature Creep for Agents Stop building features nobody needs. This skill helps you ship products that solve real problems without drowning in unnecessary complexity. Invoke when the user asks about avoid feature creep or related SKILL.md workflows.1.2kinstalls14Convex Component AuthoringThe convex-component-authoring skill guides developers building reusable Convex components that package schemas, queries, mutations, actions, and internal helpers for distribution across apps. It covers component directory layout, export surfaces, versioning expectations, and integration patterns so consuming projects can mount the component without copying implementation details. Agents help define validation with Convex validators, separate public APIs from internal tables, document install steps, and ensure auth or environment assumptions are explicit. The skill is used when extracting shared backend logic such as billing, chat, or analytics into a component library rather than monolithic convex folders. It complements general Convex app skills by focusing on packaging boundaries, migration notes, and consumer configuration.1.1kinstalls