AI agent skill · by @get-convex

Convex Crons

Add recurring scheduled jobs (crons) to the Convex app.

Archived 2026-10-23 · Source updated 2026-10-01 · License: Apache-2.0. Check the original repository for the latest version.

SKILL.md instructions

<!-- 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

1. Create convex/crons.ts with cronJobs().
2. Schedule internal functions (never public api.*) at the right interval.
3. Make handlers idempotent (safe to re-run); keep each run small.
4. 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.