One of 30 skills in the get-convex/agent-skills package — works on its own, and pairs well with its siblings.
WHEN YOUR AGENT SHOULD USE IT
USE FOR
- Run a background task at a fixed interval.
- Keep scheduled tasks private, out of reach of the app's public functions.
- Check the new job shows up in the Convex dashboard schedule.
DO NOT USE FOR
- Updates a screen should show at once: Convex pushes those without a timer.
Documents
This is the playbook your agent receives when the skill activates — you don't need to read it to use the skill, but it's here to audit before installing.
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.
Installation
Copy & paste — that's it
npx skills add get-convex/agent-skills --skill "convex-crons" --full-depthRun this in your project — your agent picks the skill up automatically.
License
Licensed under Apache-2.0— you can use, modify, and redistribute it under that license's terms.
View the full license file on GitHub →