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.

安裝量 · 446查看來源

Installation

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

技能檔案

SKILL.md

最近同步 · 2026年10月15日

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.