01
It starts by itself
convex code changes. Runs in GitHub Actions or Claude Code routine.
- ↻ convex code changes
pull_request paths: convex/**
waynesutton · 4K installsConvex Best Practices skill
Runs by itself, convex code changes.
Convex changes checked against the rules.
Install the Convex Best Practices skill and make it a habit: follow https://gethabit.dev/skills/waynesutton/convex-best-practices.md
- 1Copy
- 2Paste into Claude Code, Codex or Cursor
- 3It runs by itself
4K installs405 starsApache-2.0 licenceSource on GitHub ↗
Convex Best Practices
by waynesutton · 4K installs
The skill
Convex best practices covers the production patterns the convex eslint plugin enforces: validators, index reads, idempotent mutations, avoiding OCC write conflicts, pagination, thin wrappers and error handling.
Only when you ask.
The habit
Convex changes checked against the rules.
↻ Runs by itselfconvex code changes
How the habit works.
You don't have to.
When does it start? How does it check its work? What does it remember?
One run, step by step.
Then it stops.
Stops after the changed convex files of one pull request are reviewed.
- 01
Scope the diff
Find the changed functions and schema in the convex folder.
- 02
Check reads and writes
Confirm index reads over filters, idempotent mutations and Promise.all for independent writes.
- 03
Check safety rules
Confirm ConvexError for client messages, internal.* scheduled targets and no Date.now() in queries.
- 04
Run the linter
Run npm run lint with the convex eslint plugin to catch old syntax and missing validators.
- 05
Report against the checklist
List failures against the checklist and log recurring issues.
What it may do.
Nothing more.
It writes only in its own folder and asks you before anything goes out.
- Writes only inloops/convex-review-loop/**
- Talks tono outside service
- Sendsnothing
- Your OKNothing goes out, so it needs no OK.
Is it for you?
Use it when it fits.
Read both lists. If the left one sounds like you, the Convex Best Practices skill helps.
Use it when
- ✓ You review Convex functions
- ✓ You fix write conflicts or slow queries
- ✓ You set up the Convex ESLint plugin
Skip it when
- – The project does not use Convex
- – You want general JavaScript style rules
Convex Best Practices skill, answered.
Why indexes instead of filters?
.filter() reads every row then drops most; withIndex against a schema index reads as little as possible.
Why ConvexError over plain Error?
Plain Error messages are redacted to a generic server error in production, so clients cannot read them.
How do I install the Convex Best Practices skill?
Copy the prompt at the top into your agent. It installs the skill from waynesutton/builder-skills and sets up the habit. Or run npx skills add waynesutton/builder-skills --skill convex-best-practices.
Is the Convex Best Practices skill free?
Yes. It is published under Apache-2.0. Habit is free too.
Convex Best Practices. Now as a habit.
Install the Convex Best Practices skill and make it a habit: follow https://gethabit.dev/skills/waynesutton/convex-best-practices.md
All waynesutton skills →More code skills →
Works in
- Claude Code
- Codex
- Cursor
- ChatGPT
- Claude app
Made by waynesutton, published under Apache-2.0. Habit links to the original and never changes it. Is this your skill?