cron-mastery — Claude Code skill: what it does, install
The cron-mastery skill explains when OpenClaw should use Cron or Heartbeat, how to schedule reminders, and how to remove finished one-shot jobs.
no license 260 installs ★ 675 updated 2026-03-07
npx skills add sundial-org/awesome-openclaw-skills --skill cron-mastery -a claude-codeWhat cron-mastery does
The skill separates loose polling from fixed-time work. Heartbeat fits periodic checks, while Cron handles reminders and maintenance that must run at a set time. For delays longer than a minute, it recommends a one-shot cron:add job instead of an internal wait loop.
It includes a job pattern using an at schedule, an agentTurn payload, an isolated session, and a wake mode. Another section describes a daily Janitor that removes disabled one-shot jobs whose status is ok, while leaving recurring jobs alone. The agent also needs the user’s timezone stored in MEMORY.md; without that, a reminder such as 9 PM cannot be tied to the right local time.
What it helps with
- choose Cron or Heartbeat for a scheduled task
- create a precise one-shot reminder
- remove completed cron jobs from the list
- set up agent wake-ups after an asynchronous wait
Example prompts for the agent
- Use cron-mastery to schedule a reminder in 10 minutes with a one-shot
atjob. - Set up a daily Janitor that deletes disabled jobs with status
ok. - Explain whether Heartbeat or Cron should handle a reminder at a specific time.
How to install cron-mastery
1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill cron-mastery -a claude-code2Manually: put the files in place
~/.claude/skills/cron-mastery/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cron-mastery/
1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill cron-mastery -a codex2Manually: put the files in place
.agents/skills/cron-mastery/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill cron-mastery -a cursor2Manually: put the files in place
.cursor/skills/cron-mastery/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install sundial-org/awesome-openclaw-skills skills/cron-mastery2Manually: put the files in place
.github/skills/cron-mastery/SKILL.md1Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill cron-mastery -a gemini-cli2Platform CLI
gemini skills install https://github.com/sundial-org/awesome-openclaw-skills --path skills/cron-masteryManually: put the files in place
.devin/skills/cron-mastery/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add sundial-org/awesome-openclaw-skills --skill cron-mastery -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about cron-mastery
How do I install cron-mastery in Claude Code?
Run npx skills add sundial-org/awesome-openclaw-skills --skill cron-mastery -a claude-code. The skill file will be placed at ~/.claude/skills/cron-mastery/SKILL.md.
What does cron-mastery do?
It guides the choice between Heartbeat and Cron, shows how to schedule exact reminders, describes cleanup for completed jobs, and covers wake-ups after waiting.
What must be configured before scheduling a reminder?
The agent needs the user’s timezone saved in MEMORY.md. A specific-time reminder should be confirmed against that timezone before it is scheduled.