Convex Cron Jobs
A pattern library for setting up reliable, scalable scheduled functions (cron jobs) in Convex apps.
Dev & CodingIntermediate★ 404⑂ 32AI score 7/10Last updated: Feb 6, 2026
What it does
- Generates scheduling code with
crons.interval(seconds/minutes/hours) andcrons.cron(cron expressions). - Shows how to write internal functions for crons, pass static args, and log runs to a
cronLogstable. - Covers batching large datasets via
paginate+ctx.scheduler.runAfter, and external API calls viainternalAction. - Lists common pitfalls: calling public functions, UTC timezone confusion, deprecated helpers, missing error handling.
Who it's for
- Developers building on Convex as a backend
- Teams automating session cleanup, data sync, and daily/weekly reports
- Engineers hardening production cron monitoring and logging
Examples
- "Add a cron that cleans up expired sessions hourly" → produces
convex/crons.tsplus aninternalMutation - "Send a weekly summary every Monday at 9 AM UTC" → uses the
0 9 * * 1expression - "My cron times out on tens of thousands of rows" → refactors into 100-item batches with cursor re-scheduling
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/waynesutton/convexskills/HEAD/skills/convex-cron-jobs/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/convex-cron-jobs folder from the GitHub repo waynesutton/convexskills into my ~/.claude/skills/convex-cron-jobs/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/waynesutton/convexskills.git /tmp/convexskills && mkdir -p ~/.claude/skills && cp -r /tmp/convexskills/skills/convex-cron-jobs ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repo:
git clone https://github.com/waynesutton/convexskills.git - Create the skills directory if needed:
mkdir -p ~/.claude/skills - Copy just this skill:
cp -r convexskills/skills/convex-cron-jobs ~/.claude/skills/ - Verify that
~/.claude/skills/convex-cron-jobs/SKILL.mdexists. - Restart Claude Code and try a prompt like "set up a Convex cron job" to confirm it loads.
- Note: you need an actual Convex project (a
convex/directory andnpx convex dev) to apply the generated code.
View source on GitHub ↗License: Apache-2.0