Name: Cron Scheduler
Author: garrytan

Convention: See skills/conventions/test-before-bulk.md — test every cron job on 3-5 items first.

Contract

This skill guarantees:

Schedule staggering: max 1 job per 5-minute slot, no collisions
Quiet hours gating: timezone-aware, with user-awake override
Thin job prompts: jobs say "Read skills/X/SKILL.md and run it" (no inline 3000-word prompts)
Idempotency: jobs can run twice without duplicate side effects
Results saved as reports: reports/{job-name}/{YYYY-MM-DD-HHMM}.md

Phases

Define job. Name, schedule (cron expression), skill to run, timeout.
Validate schedule. Check no collision with existing jobs (5-minute offset rule).
- Slots: :05, :10, :15, :20, :25, :30, :35, :40, :45, :50
- If collision detected, suggest the next available slot

Convention: See skills/conventions/test-before-bulk.md — test every cron job on 3-5 items first.

This skill guarantees:

Schedule staggering: max 1 job per 5-minute slot, no collisions
Quiet hours gating: timezone-aware, with user-awake override
Thin job prompts: jobs say "Read skills/X/SKILL.md and run it" (no inline 3000-word prompts)
Idempotency: jobs can run twice without duplicate side effects
Results saved as reports: reports/{job-name}/{YYYY-MM-DD-HHMM}.md

Define job. Name, schedule (cron expression), skill to run, timeout.
Validate schedule. Check no collision with existing jobs (5-minute offset rule).
- Slots: :05, :10, :15, :20, :25, :30, :35, :40, :45, :50
- If collision detected, suggest the next available slot