skill CX Codex

convex-crons — Claude Code skill: what it does, how to install

Q: How to install convex-crons in Claude Code?

Run `npx skills add convex/agent-skills --skill convex-crons -a claude-code`.

Q: What does convex-crons do?

It guides the agent to define scheduled tasks in `convex/crons.ts` targeting internal Convex functions with safe intervals.

Q: Which Convex functions can be scheduled by cron?

Only functions under `internal.*` are allowed. Scheduling public `api.*` endpoints in crons is prohibited.

Adds recurring scheduled jobs to Convex applications. Useful when you need to schedule backend maintenance and periodic cleanups.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add convex/agent-skills --skill convex-crons -a claude-code

Open on GitHub

What convex-crons does

The skill configures recurring background jobs in convex/crons.ts using cronJobs(). It directs the agent to target only internal.* functions, strictly avoiding public api.* endpoints.

Every cron handler must remain small and idempotent. That keeps reruns safe if an execution fails midway. Once defined, the job schedule can be verified directly in the Convex dashboard.

Tight polling intervals are discouraged by design. If data can sync via Convex subscriptions, running periodic polling jobs violates the skill rules.

What it helps with

create convex/crons.ts with recurring job schedules
bind internal.* functions to execution intervals
write idempotent handlers for background routines
verify scheduled tasks in the Convex dashboard

Example prompts for the agent

Set up a daily cleanup job in convex/crons.ts using internal functions
Add an hourly cron job in Convex to archive old logs idempotently

How to install convex-crons

1Skills CLI (Vercel)

npx skills add convex/agent-skills --skill convex-crons -a claude-code

2Manually: put the files in place

~/.claude/skills/convex-crons/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/convex-crons/

1Skills CLI (Vercel)

npx skills add convex/agent-skills --skill convex-crons -a codex

2Manually: put the files in place

.agents/skills/convex-crons/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add convex/agent-skills --skill convex-crons -a cursor

2Manually: put the files in place

.cursor/skills/convex-crons/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install convex/agent-skills convex-crons

2Manually: put the files in place

.github/skills/convex-crons/SKILL.md

1Skills CLI (Vercel)

npx skills add convex/agent-skills --skill convex-crons -a gemini-cli

2Platform CLI

gemini skills install https://github.com/convex/agent-skills --path skills/convex-crons

Manually: put the files in place

.devin/skills/convex-crons/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add convex/agent-skills --skill convex-crons -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about convex-crons

How to install convex-crons in Claude Code?

Run npx skills add convex/agent-skills --skill convex-crons -a claude-code.

What does convex-crons do?

It guides the agent to define scheduled tasks in convex/crons.ts targeting internal Convex functions with safe intervals.

Which Convex functions can be scheduled by cron?

Only functions under internal.* are allowed. Scheduling public api.* endpoints in crons is prohibited.

Source text

SKILL.md · Apache-2.0

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

Similar skills

Everything for Backend and APIs →

convex waynesutton Routes Convex backend tasks to dedicated builder skills and enforces global rules for queries, mutations, and schemas. Useful as the starting point for any Convex project. CX Codex +1 5,700installs convex-best-practices waynesutton Guides your agent through production Convex patterns, from index design to OCC conflict prevention. Essential for clean mutations, schema validation, and fast queries. CX Codex +1 3,900installs mcp-builder official anthropics This skill walks through building an MCP server in TypeScript or Python, from reading the protocol spec to writing tests and evaluation questions. 130,949installs claude-api official anthropics Reference skill for the Claude API and Anthropic SDK that enforces valid model IDs, adaptive thinking, and streaming. 74,198installs lark-im larksuite This skill lets an agent work with Lark IM messages, chats, files, and interactive cards. Use it when coding tasks need access to team conversations. CX Codex +1 472,900installs lark-event larksuite Listens to Lark/Feishu events and streams them as NDJSON. Use it for bots, message processing, and long-running subscribers. CX Codex +1 466,800installs caveman-discover JuliusBrussee Finds and labels every LLM workflow in your repository so Caveman Cloud breaks down spend by actual job rather than grouping everything into one bucket. CX Codex +1 104,400installs migration JuliusBrussee Enforces reversible, compatibility-safe transitions for schema, data, and API updates. Useful whenever data loss or rollout downtime is unacceptable. CX Codex +1 103,900installs

From the same set32

convex-reviewer Walks Convex code through auth, validator, index and reactivity checks. Useful before you ship backend functions. CX Codex +1 36,100installs convex-docs Pins the project's installed Convex version and fetches current markdown docs or checks types instead of generating outdated API calls. CX Codex +1 36,100installs convex-add Adds hosting or another backend capability to the current Convex app. Use it when you want an agent to locate and wire a requested component. CX Codex +1 35,900installs convex-advisor Reads a Convex deployment's 72h insights, root-causes each event in code, and reports fixes ranked by severity. CX Codex +1 35,900installs convex-env This skill sets and wires Convex deployment environment variables and secrets. Use it when actions need deployment-specific values without putting secrets in code. CX Codex +1 36,000installs convex-seed Populates Convex database tables with sample rows or imports external datasets. Useful when preparing dev environments without manual data entry. CX Codex +1 35,800installs convex-verify convex-verify tests a Convex feature with seeded data, multiple mocked identities, and negative authorization checks. Use it for a specific feature you have built or changed. CX Codex +1 35,800installs convex-monitor This skill blocks on the next event in a Convex app — a dev error, a prod error or a feature request — and hands it to the agent. CX Codex +1 35,800installs