convex-crons

get-convex/agent-skills/convex-crons

This skill provides guidance on defining recurring scheduled jobs (crons) in a Convex application. It outlines a workflow for creating a convex/crons.ts file, scheduling internal functions (never public API functions), and ensuring handlers are idempotent and keep each run small. It also emphasizes avoiding tight polling intervals and verifying the job appears in the dashboard.

Installs · 446View source

Installation

npx skills add https://github.com/get-convex/agent-skills --skill convex-crons

Skill files

SKILL.md

Last synced · Oct 15, 2026

SKILL.md›

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

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.