MarketplaceSKILL.mdLeída en 82d1ce2
convex
Routes Convex work to the right builder skill and covers the handful of rules that apply everywhere: validators on every function, withIndex over filter, idempotent mutations, internal functions for scheduling. Use when a task mentions Convex and no more specific skill matches, or as the first stop before picking one.
Resumen
Convex
Start here, pick the matching skill below, and load it. If nothing matches, the rules at the bottom still apply.
Pick a skill
| Skill | Load when |
|---|---|
| convex-best-practices | general patterns, project structure, "is this the Convex way" |
| convex-functions | queries, mutations, actions, internal functions, error handling |
| convex-schema-validator | tables, indexes, validators, v.* types, schema changes |
| convex-realtime | useQuery, optimistic updates, pagination, presence, rerender churn |
| convex-http-actions | webhooks, REST endpoints, convex/http.ts, Stripe or Clerk callbacks |
| convex-file-storage | uploads, upload URLs, serving files, storage cleanup |
| convex-cron-jobs | crons.ts, runAfter, runAt, batching, a cron that is not firing |
| convex-migrations | backfills, renaming fields, schema evolution with live data |
| convex-agents | AI agents, threads, tools, streaming, RAG with @convex-dev/agent |
| convex-component-authoring | building a reusable component package, defineComponent |
| convex-security-check | fast pre ship audit: auth on public functions, exposed data |
| convex-security-audit | deep review: authorization model, injection, rate limits, secrets |
| avoid-feature-creep | scope pushback, MVP cuts, "just one more feature" |
| project-workflow | multi step tasks, PRDs in prds/, task.md, plans for review |
| project-docs | syncing task.md, changelog.md, files.md with shipped code |
| git-safety | revert, undo, reset, checkout, clean, stash, force push |
Two skills often apply at once. Load the domain skill for the code and the process skill for the workflow, for example convex-functions plus project-workflow.
Rules that hold everywhere
- Every function declares
argsandreturnsvalidators, including internal ones. - Read through
withIndex..filter()on a table scan is a bug waiting for data. - Mutations are idempotent. Check current state, return early when there is nothing to do.
- Schedule and cron only
internal.*functions. Neverapi.*. - Never call
Date.now()inside a query. Pass time in as an argument. - Use
npx convex devfor development. Do not runnpx convex deployunless asked. - Fetch https://docs.convex.dev/llms.txt before trusting memory about an API.
Do not
- Edit anything under
convex/_generated/. - Use
crons.daily,crons.hourly, orcrons.weekly. Usecrons.intervalorcrons.cron. - Put
"use node"in a file that also exports queries or mutations. - Run git commands that discard work without loading git-safety first.
Docs
- https://docs.convex.dev/llms.txt
- https://docs.convex.dev/understanding/best-practices
- https://docs.convex.dev/functions
Archivos 4 archivos
Instálala a mano
Deska ejecuta esto por ti, para cada agente que elijas. Para ejecutarlo tú en una terminal:
npx skills add waynesutton/builder-skills --skill convexMás de waynesutton
- convex-best-practiceswaynesuttonProduction patterns for Convex apps and the rules the @convex-dev/eslint-plugin enforces: validators, indexes, idempotent mutations, avoiding OCC conflicts, thin function wrappers, error handling. Use when reviewing Convex code, asking whether a pattern is right, setting up ESLint, or fixing write conflicts and slow queries.3,800 instalaciones en skills.sh0
- convex-functionswaynesuttonWrites Convex queries, mutations, actions, and internal functions in the object form with args and returns validators, correct ctx usage, runtime boundaries, and error handling. Use when adding or changing anything in convex/*.ts that exports a function, or when deciding between query, mutation, and action.3,100 instalaciones en skills.sh0
- convex-schema-validatorwaynesuttonDesigns convex/schema.ts tables, validators, indexes, and relationships, and keeps the schema honest as data evolves. Use when creating tables, adding fields, choosing index fields, modeling relationships, or when a validator error appears at deploy time.2,900 instalaciones en skills.sh0
- convex-realtimewaynesuttonBuilds reactive UIs on Convex subscriptions: useQuery patterns, optimistic updates, pagination that stays live, presence, and avoiding subscription churn. Use when wiring the frontend to Convex, when data does not update live, or when a page rerenders too much.2,800 instalaciones en skills.sh0
- convex-cron-jobswaynesuttonSchedules work in Convex: cron jobs in convex/crons.ts, one off scheduled functions with runAfter and runAt, batching large jobs, and cancelling or inspecting the queue. Use when something needs to run on a timer, later, or in the background, or when a cron is not firing.2,700 instalaciones en skills.sh0