schedule
Installation
SKILL.md
Schedule
Register a scheduled task — one-shot or recurring — that runs reliably whether the user is logged on, on battery, or idle. Cross-platform: Windows (Task Scheduler), Linux (systemd-run --user), macOS (launchd).
When to use
- User wants a command/script/AI prompt to run later (delay or absolute time, one-shot).
- User wants a recurring trigger — every N seconds/minutes/hours, daily at HH:MM, weekly on specific days, or a calendar spec ("Mondays at 09:00", "--* 18:00:00").
- User wants to chain a follow-up after a long-running build/release that exceeds a single agent turn.
- User asks to "schedule", "queue", "run in X minutes", "fire at HH:MM", "every day at HH:MM", "every N minutes".
Recurring tasks have no auto-stop; the user is responsible for cancelling when done (Unregister-ScheduledTask / systemctl --user stop / launchctl bootout). Surface this on registration. The skill registers; it does not own a lifetime policy.
Workflow
- Detect the platform and load the matching reference:
- Windows →
references/windows.md(Task Scheduler /Register-ScheduledTask) - Linux →
references/linux.md(systemd-run --user, fallbackat) - macOS →
references/macos.md(launchd LaunchAgent plist)
- Windows →