Generated banner for Convex Crons
Generated logo for Convex Crons

Convex Crons

ConvexOfficialPublished by Convex

  • Skill
  • Workflow
  • Software development
  • Apache-2.0
  • No issues found

From the author

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

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides a structured approach to implementing cron jobs in a Convex environment. It emphasizes the use of internal functions to ensure secure and efficient background task execution, while providing best practices for handler design to maintain system stability.

What it does

  • Guides the creation of a dedicated cron configuration file.
  • Defines the process for scheduling internal functions at specific intervals.
  • Outlines requirements for idempotent handler design.
  • Provides verification steps for monitoring scheduled jobs via the dashboard.

When to use it

  • When you need to perform recurring background tasks in a Convex app.
  • When you need to automate maintenance or data cleanup routines.
  • When you need to trigger periodic updates that do not require user interaction.

Advantages

  • Ensures background tasks are isolated from public API endpoints.
  • Promotes system reliability through idempotent job design.
  • Provides a clear, centralized configuration for all scheduled tasks.

Usage examples

“How do I set up a daily cleanup job in my Convex app?”
The agent will guide you through creating a convex/crons.ts file, defining an internal cleanup function, and registering it with the cronJobs() scheduler.
“What are the best practices for writing a Convex cron handler?”
The agent will explain the importance of keeping handlers small and ensuring they are idempotent so that repeated executions do not cause data corruption.

Install

  1. Download the skill as a ZIP:

    https://autogineer.com/agent-skills/convex/convex-crons/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip convex-crons.zip -d .agents/skills

Documentation by Convex

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

Files

ATTRIBUTION.md

Attribution

This folder is an unmodified copy of the Agent Skill "convex-crons", distributed by AutoGineer (https://autogineer.com/agent-skills).

The skill's own files are unmodified copies. AutoGineer is not affiliated with or endorsed by the author or the publisher.

Files added by AutoGineer

  • ATTRIBUTION.md: this file, written by AutoGineer

  • LICENSE: copied from LICENSE

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Convex
Publisher
Convex (Official)
Source
convex/agent-skills · skills/convex-crons · commit f60629d
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Convex or Convex.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download convex-crons.zip