How to use the Convex Scheduled Jobs agent skill (convex-crons)

What is an agent skill?

An agent skill is a folder containing a SKILL.md file with instructions that an AI agent reads when a task matches the skill's description. Once a skill is installed, you do not need to paste the instructions into each chat; the agent loads them when relevant.

This skill is named convex-crons and its SKILL.md is the only file it ships with.

What the skill makes the agent do

When the skill applies, the agent sets up recurring background tasks in your Convex app, such as jobs that run every few minutes or every few hours. It follows a four-step workflow defined in the skill: create convex/crons.ts with cronJobs(), schedule internal functions at the right interval, make the handlers idempotent so they are safe to re-run while keeping each run small, and verify that the job appears in the dashboard schedule.

• Creates a convex/crons.ts file that uses cronJobs()
• Points each job at an internal.* function, never a public api.* function
• Writes handlers that are safe to re-run and small in scope
• Reminds the agent to confirm the job shows in the Convex dashboard schedule

How to install the convex-crons skill

Download the convex-crons ZIP from this page. Then choose one of two install locations.

For a personal setup available across projects, unzip the file into ~/.claude/skills/. For a single project, unzip it into that project's .claude/skills/ folder. Either way the result should be a convex-crons folder containing SKILL.md.

You can also upload the skill in the Claude apps under Settings → Capabilities → Skills.

• Personal: ~/.claude/skills/
• Project only: .claude/skills/ inside your project

How to trigger the skill with natural requests

You do not need a special command. Describe the recurring work you want in ordinary language and mention Convex, so the agent matches the request to this skill. The skill's description covers adding recurring scheduled jobs (crons) to a Convex app.

• Add a cron to my Convex app that deletes expired sessions every 30 minutes.
• Set up a scheduled job in Convex that syncs our orders table to the billing service every hour.
• Create a recurring Convex job that sends a reminder email each morning.

What you need before you start

The skill only applies to Convex apps. You need a Convex project, along with the Convex platform and its CLI and dashboard, because the agent's final check is to confirm the job appears in the dashboard schedule.

The skill does not run scripts and does not use the network. It is a set of written instructions in SKILL.md.

• A Convex project
• Access to the Convex dashboard to verify the schedule

Safety notes and what to review

The skill tells the agent to schedule internal functions rather than public ones, so scheduled work is not exposed as a public API. Still, review the generated convex/crons.ts and the handler code before deploying, especially if a job changes or deletes data.

Because the skill does not run scripts or use the network, its risk comes from the code the agent writes in your project, not from the skill files themselves.

• Confirm each job targets internal.* functions
• Read the handler for deletes or writes and check it is safe to repeat
• Check the job's interval against how fresh the data needs to be

Tips for better results

Say how often the job should run and what it should do. The skill advises against tight polling for data that a subscription could push, so if you ask for a very frequent check, the agent may suggest a subscription instead.

Keep each job focused on one task. The skill asks for small handlers, which makes re-runs safer and easier to debug.

• State the interval in plain terms, such as every 15 minutes or once a day
• Describe the data the job touches so idempotency can be designed for it
• Ask the agent to show the dashboard schedule check at the end