convex-crons
get-convex/agent-skills
Add recurring scheduled jobs to Convex apps with idempotent handlers.
What is convex-crons?
This skill lets you define and manage recurring scheduled jobs (crons) in your Convex backend. Use it when you need to run tasks periodically—like cleanup, syncing, or maintenance—without external services.
- Create cronJobs() definitions in convex/crons.ts
- Schedule internal functions at specified intervals
- Ensure handlers are idempotent and safe to re-run
- Monitor scheduled jobs in the Convex dashboard
- Keep cron execution lightweight and efficient
How to install convex-crons
npx skills add https://github.com/get-convex/agent-skills --skill convex-crons- Convex project set up
- Node.js and npm installed
How to use convex-crons
- 1.Run npx skills add https://github.com/get-convex/agent-skills --skill convex-crons
- 2.Create convex/crons.ts in your project
- 3.Define cronJobs() with internal.* function targets and intervals
- 4.Implement handlers as idempotent functions (safe to run multiple times)
- 5.Deploy and verify jobs appear in the Convex dashboard
Use cases
- Run periodic database cleanup or archival tasks
- Sync data between systems on a schedule
- Send batch notifications or reports at fixed times
- Refresh cached data at regular intervals
- Perform maintenance operations like log rotation
- Convex backend developers
- Full-stack engineers building serverless apps
- Teams needing scheduled task automation
convex-crons FAQ
No. You must schedule only internal.* functions, never api.* endpoints, to keep crons private and secure.
Convex will retry the job according to its retry policy. Ensure your handler is idempotent so retries don't cause issues.
View scheduled jobs and their execution history in the Convex dashboard under the schedule section.
No. Use subscriptions or webhooks for real-time data. Crons are best for periodic batch operations and maintenance tasks.
Full instructions (SKILL.md)
Source of truth, from get-convex/agent-skills.
name: convex-crons description: "Add recurring scheduled jobs (crons) to the Convex app."
<!-- GENERATED from convex-agents content/capabilities/crons.json — do not edit by hand. -->Add scheduled jobs (crons)
Define recurring jobs in convex/crons.ts targeting internal functions, with sane intervals and idempotent handlers.
Workflow
- Create convex/crons.ts with cronJobs().
- Schedule internal functions (never public api.*) at the right interval.
- Make handlers idempotent (safe to re-run); keep each run small.
- Verify the job appears in the dashboard schedule.
Rules
- Schedule internal.* functions, never api.*.
- Keep cron handlers small + idempotent.
- Don't poll tight intervals for things a subscription can push.
Related skills
More from get-convex/agent-skills and the wider catalog.
convex-deploy-guard
Classify and announce Convex deployment targets before acting; gate production changes with fresh per-action consent.
convex-design
Design and build reactive, type-safe production backends on Convex with schema, auth, real-time, and LLM workflows.
convex-docs
Fetch version-current Convex docs instead of writing stale APIs from memory.
convex-domains
Point your own domain at a Convex app with DNS records, custom-domain attachment, and auth-origin rebinding.
convex-env
Set and manage Convex deployment environment variables and secrets securely.
convex-expert
Convex backend specialist for queries, mutations, actions, schemas, and real-time functions.