cron-scheduler

Schedule cron jobs with collision-free staggering and timezone-aware quiet-hours gating.

5|1|Updated Apr 15, 2026
One-click install
npx skills add https://github.com/GYF0311/lorekit --skill cron-scheduler-gyf0311
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cron-scheduler
Source: https://github.com/GYF0311/lorekit/tree/main/brain/skills/cron-scheduler
Command: npx skills add https://github.com/GYF0311/lorekit --skill cron-scheduler-gyf0311

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents overlapping cron executions and stops jobs from delivering output during defined quiet hours, while still ensuring work continues safely by queueing and releasing later.

Core Features & Use Cases

  • Schedule staggering with collision validation: Enforces a max-1 job per 5-minute slot rule and suggests the next available slot when conflicts are detected.
  • Quiet hours gating with wake-up override: Uses timezone-aware quiet hours (default 11 PM–8 AM) and holds outputs during quiet hours, releasing them when the user is reachable again.
  • Idempotent cron delivery with thin prompts and persisted reports: Ensures re-runs produce the same results, uses checkpointing, and saves outcomes as timestamped reports under reports/{job-name}/.

Quick Start

Ask your AI agent to schedule a new job by providing the job name, a cron expression, the target skill to run, and an explicit timeout.

Frequently Asked Questions about cron-scheduler

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent overlapping cron jobs from running at the same time?

To prevent overlapping cron jobs, use schedule staggering with collision validation. This enforces a maximum of one job per five-minute slot and suggests the next available time slot when conflicts are detected.

Can I hold scheduled job outputs during quiet hours and release them later?

Yes, timezone-aware quiet hours gating holds outputs during defined periods, defaulting to 11 PM to 8 AM. It queues work safely and releases outputs when the user is reachable again.

How do I schedule idempotent cron jobs that produce consistent results on re-runs?

To schedule idempotent cron jobs, use checkpointing and timestamped report persistence. This ensures re-runs produce identical results and saves outcomes safely under reports/{job-name}/ directories.

How do I register a new cron job with an explicit timeout?

To register a new cron job, provide the job name, a cron expression, the target skill to run, and an explicit timeout. The scheduler validates slot collisions before confirming the registration.

Does quiet hours scheduling support a wake-up override for urgent jobs?

Yes, the quiet hours gating includes a wake-up override feature. This allows urgent automation workflows to bypass the hold-and-release policy and deliver outputs immediately during quiet periods.