К основному содержанию
скилл CX Codex

schedule · sethgammon — скилл для Claude Code: планировщик cron-задач

Ставит повторяющиеся и разовые задачи по cron: по умолчанию пишет запись в Task Scheduler или Unix cron, а не расходует квоту routine-запусков.

MIT ★ 937 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local
Открыть на GitHub

Что делает schedule

На просьбу «проверяй PR каждый час» скилл переводит фразу в cron-выражение, показывает частоту, проект и команду, а после подтверждения вызывает node scripts/local-schedule.js add "<expr>" "<command>" --confirm. Так появляется запись в Windows Task Scheduler или Unix cron. Она переживает конец сессии и перезагрузку, квоту routine-запусков не трогает.

/schedule list и /schedule remove {id} идут через тот же скрипт. Каждая задача держится на файле .citadel/schedules/<id>.json: удалите его — выполнение прекратится, но инертная запись в ОС останется. Флаг --remote переключает на CronCreate, а тот живёт только до конца сессии и считает каждый запуск в общий на аккаунт лимит 15 запусков за 24 часа.

В Codex путь другой: node scripts/codex-automation.js plan --type schedule --cadence "<expr>" --command "<command>" --write выдаёт prompt для автоматизации в приложении и пишет .planning/codex-automations/{id}.json; если папки .planning/ нет, её создают заранее. Для запусков, которым нужно пережить сон машины или обрыв сети, описан облачный RemoteTrigger, но ему нужен Claude с облачными функциями на плане Pro или Team. Задачи снимают до удаления скилла.

Какие задачи решает

  • поставить проверку PR каждый час без ручного запуска
  • свести «каждые 30 минут» к cron-выражению
  • снять задачу по ID, когда она больше не нужна
  • сохранить расписание после перезагрузки машины
  • завести расписание в Codex, не завися от открытого терминала

Примеры запросов агенту

  • Поставь проверку PR каждый час и сначала покажи cron-выражение
  • Покажи активные задачи через /schedule list
  • Сними задачу по ID, который вернул /schedule list

Как установить schedule

1Через маркетплейс плагинов

/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local

Команда ставит плагин citadel целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add SethGammon/Citadel --skill schedule -a claude-code

3Вручную: положить файлы

~/.claude/skills/schedule/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/schedule/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о schedule

Как установить schedule в Claude Code?

Добавьте маркетплейс командой /plugin marketplace add SethGammon/Citadel, затем поставьте плагин: /plugin install citadel@citadel-local.

Что делает schedule?

Переводит интервал вроде «каждые 30 минут» в cron-выражение и заводит задачу: по умолчанию в планировщике ОС, с флагом --remote — в routine-системе Anthropic.

Зачем нужен флаг --remote?

Он переключает на CronCreate: задача живёт только в текущей сессии, а каждый запуск идёт в лимит 15 запусков за 24 часа на аккаунт.

Исходный текст

SKILL.md · MIT
---
name: schedule
license: MIT
description: >-
  Manages recurring and one-off scheduled tasks. Session-scoped scheduling via
  CronCreate/CronDelete/CronList. Documents the cloud path for tasks that need
  to survive machine sleep or network drops.
user-invocable: true
auto-trigger: false
trigger_keywords:
  - schedule
  - recurring
  - every N minutes
  - cron
  - set a reminder
  - run periodically
last-updated: 2026-03-26
---

# /schedule — Task Scheduling

## Orientation

**Use when:** scheduling a recurring or one-off remote agent run (cron-style, outside the current session).
**Don't use when:** repeating work within the current session (use /loop); continuous unattended campaigns (use /daemon).

## Default execution path (READ FIRST)

**`/schedule add` does NOT call `CronCreate` by default.** It shells out to
`node scripts/local-schedule.js` which installs a native OS entry (Windows
Task Scheduler or Unix cron). Only pass `--remote` to use Anthropic's routine
system, and only after explicit user confirmation.

**Why:** `CronCreate` counts against the account-wide **15 routine runs / 24h**
cap; every fire of the scheduled task counts. See
[docs/ROUTINE-QUOTA.md](../../docs/ROUTINE-QUOTA.md).

### Default flow — `/schedule add "<expr>" "<command>"` (no `--remote`)
Run:
```bash
node scripts/local-schedule.js add "<expr>" "<command>" --confirm
```
Before running, show the cadence, project, prompt and persistence and obtain
approval to create the OS task. Normal Claude permissions remain enabled. Do not
add a bypass flag to make unattended execution succeed.

Then report the returned ID and the removal command. This survives session
end, machine reboot, and consumes zero routine quota. Use
`/schedule list` and `/schedule remove {id}` (which also shell out to
`local-schedule.js`) by default. Remove tasks before uninstalling. New jobs require
their `.citadel/schedules/<id>.json` record; deleting it disables execution but leaves
an inert OS entry. Existing jobs retain their old bypass flags until explicitly
removed and recreated. See [runner safety and migration](../../docs/ISSUE-278-SECURITY.md).

### Codex automation lane

When running in Codex and the user wants the schedule to survive the current terminal session, create a Codex Automation plan instead of a local OS entry:

```bash
node scripts/codex-automation.js plan --type schedule --cadence "<expr>" --command "<command>" --write
```

Give the returned `prompt` to the Codex app automation surface and keep the generated `.planning/codex-automations/{id}.json` as the durable Citadel record.

If `.planning/` does not exist, create it before writing automation state.

### Opt-in routine flow — `/schedule add --remote ...`
Only when `--remote` is explicitly passed:
1. Confirm: "This will use `CronCreate`, which counts against your 15 routine
   runs / 24h quota and is cleared at session end. Continue? (y/N)"
2. On confirmation, run the `CronCreate`-based flow documented below.

The rest of the protocol documents the full `CronCreate` flow for reference
and for `--remote` invocations.

## When to Route Here

- "run pr-watch every hour"
- "check my PRs automatically"
- "schedule a thing"
- "remind me to run tests every 30 minutes"
- "set up a recurring task"
- "list my scheduled tasks"
- "cancel the PR check"
- Any mention of "schedule", "recurring", "every N minutes/hours", "cron"

## Protocol

### /schedule list

List all currently scheduled tasks using CronList.

Output format:
```
Active schedules (N):
  [id] {description} — {cron expression} — next run: {time}

No schedules active.
```

If CronList is not available: output a helpful error (see Fringe Cases).

---

### /schedule add "{description}" {/skill-or-command}

Create a recurring task.

Steps:
1. Parse the user's description to extract:
   - Natural language interval: "every 30 minutes", "hourly", "every day at 9am"
   - The skill or command to run: `/pr-watch`, `/do status`, etc.
2. Convert natural language to a cron expression (see Conversion Table below)
3. Confirm with user: "I'll run `{command}` {natural-language-interval} (cron: `{expression}`). OK?"
4. If confirmed: call CronCreate with the expression and command
5. Output: "Scheduled. ID: {id}. Use `/schedule remove {id}` to cancel."

**Cron Expression Conversion Table:**

| Natural Language | Cron Expression |
|---|---|
| every minute | `* * * * *` |
| every 5 minutes | `*/5 * * * *` |
| every 15 minutes | `*/15 * * * *` |
| every 30 minutes | `*/30 * * * *` |
| every hour / hourly | `0 * * * *` |
| every 2 hours | `0 */2 * * *` |
| every 6 hours | `0 */6 * * *` |
| every day / daily | `0 9 * * *` (default 9am) |
| every day at {H}am/pm | `0 {H} * * *` |
| every weekday | `0 9 * * 1-5` |
| every Monday | `0 9 * * 1` |

If the user provides a raw cron expression directly, use it as-is without
converting. Validate it has 5 fields before accepting.

---

### /schedule remove {id}

Remove a scheduled task by ID using CronDelete.

If the user doesn't know the ID: run `/schedule list` first, show the list,
and ask which one to remove.

Output: "Removed schedule {id} ({description})."

---

### /schedule status

Show all active schedules and their next run times. Equivalent to `/schedule list`
with additional context about what each task does and when it last ran (if available).

---

## Session-Scoped vs. Cloud-Persistent Scheduling

### Session-Scoped (CronCreate)

CronCreate schedules tasks that run during the **current Claude Code session only**.
When the session ends (Claude Code closes or the conversation is reset), all
session-scoped schedules are cleared.

**Use session-scoped when:**
- Running checks during an active work session ("remind me every 30min to commit")
- Polling for PR feedback while you're at the computer
- Triggering skill runs during a long coding session

### Cloud-Persistent (RemoteTrigger)

For tasks that need to survive machine sleep, network drops, or session restarts,
use **RemoteTrigger** — a one-off cloud trigger that fires from Anthropic's
infrastructure rather than your local session.

**Use cloud-persistent when:**
- The task needs to run overnight or while you're away
- You want notifications when you return to your machine
- The interval spans multiple days or calendar dates

**How to set up a one-off cloud trigger:**
1. Call RemoteTrigger with the desired delay and the command to run
2. Claude Code registers the trigger in Anthropic's cloud scheduler
3. When the trigger fires, it wakes a new Claude Code session and runs the command
4. Results are delivered as a notification

**Note:** RemoteTrigger requires Claude Code with cloud features enabled (Pro or
Team plan). CronCreate works on all plans but is session-scoped only.

---

## Fringe Cases

**CronCreate not available:** Output error; suggest OS cron/Task Scheduler. Never fail silently.
**Ambiguous interval:** Ask for clarification before proceeding.
**Raw cron expression:** Accept without conversion; validate 5 fields.
**Every-minute schedule:** Warn about 60 fires/hour; suggest 5m or 15m instead.
**No schedules when listing:** "No active schedules. Use `/schedule add` to create one."
**Pause requested:** Explain pause isn't supported; remove and recreate instead.

---

## Contextual Gates

**Disclosure:** "Creating schedule: `{command}` at `{cron expression}`. OK?"
**Reversibility:** amber — creates OS cron entries or CronCreate sessions (side effects outside the repo); undo with `/schedule remove {id}`
**Trust gates:**
- Any: confirms before creating; shows cron expression before accepting

## Quality Gates

- Always confirm before creating (CronCreate is a side effect)
- Always show the cron expression alongside the natural-language description
- Always provide the ID after creation so the user can remove it
- Never leave a user unable to remove a schedule they created

## Exit Protocol

/schedule does not produce a HANDOFF block. After each action, output a concise
confirmation or list and wait for the next command.

- After `add`: "Scheduled. ID: {id}. Use `/schedule remove {id}` to cancel."
- After `remove`: "Removed schedule {id}."
- After `list` or `status`: the active schedule list (or "No active schedules.")
- After any error: a clear message and actionable suggestion.

© SethGammon · MIT · SethGammon/Citadel

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →

Сначала — schedule от других авторов.

schedule orwa-mahmoud Скилл schedule для Claude Code печатает конфигурацию для запуска смены по расписанию. Он проверяет рабочее пространство и очередь задач перед генерацией настроек планировщика. CX Codex +1 ★ 571звёзд репо crontap-schedule-http-job Crontap Скилл crontap-schedule-http-job позволяет настраивать регулярные вызовы HTTP-эндпоинтов, вебхуков и облачных функций через Crontap с предпросмотром расписания cron или естественного языка. CX Codex +1 1 300установок cron-schedule ruvnet Скилл cron-schedule для Claude Code запускает фоновые задачи по расписанию через CronCreate в активной сессии. Он выполняет аудит кода, собирает карту проекта и обновляет тесты. CX Codex +1 903установок c-schedule daxaur Скилл c-schedule ставит повторяющиеся задачи Claude на launchd или cron, следит за расходом и отдаёт результат в Telegram, файл или уведомление. CX Codex +1 ★ 179звёзд репо loopify coreyhaines31 Скилл loopify помогает превратить «эту задачу надо гонять регулярно» в рабочий цикл: выбирает ритм, следит за идемпотентностью и ставит условие выхода. CX Codex +1 383установок c-cron daxaur Скилл c-cron для Claude Code и Codex, управляет повторяющимися задачами macOS через crontab и launchctl. CX Codex +1 ★ 179звёзд репо recipe-schedule-recurring-event официальный googleworkspace Скилл recipe-schedule-recurring-event для Google Workspace в Claude Code создаёт повторяющиеся события в Google Calendar с автоматической рассылкой приглашений. Работает во всех платформах AI-кодинга. CX Codex +1 31 300установок

Из того же набора55

Весь набор →
arbiter arbiter — субагент для Claude Code, который повторно запускает проверки проекта и выносит итоговый вердикт по изменениям. Его подключают после исчерпания повторных попыток рабочего агента или для оценки целостности результата. CX Codex ★ 937звёзд репо infra-audit Скилл infra-audit сканирует docker-compose, env-файлы, ORM-конфиги и строки подключения, чтобы собрать карту инфраструктуры проекта и найти, какого слоя не хватает. CX Codex +1 ★ 937звёзд репо refactor Скилл refactor для Claude Code выполняет рефакторинг нескольких файлов с автооткатом через Git, проверкой типов и тестами до и после правок. CX Codex +1 ★ 937звёзд репо review Скилл review проводит код-ревью в пять проходов: проверяет корректность, безопасность, производительность, читаемость и согласованность кода. Подходит для проверки файла, каталога или изменений Git. CX Codex +1 ★ 937звёзд репо qa Скилл qa запускает браузер через Playwright, проходит пользовательские сценарии веб-приложения и сохраняет отчёт со скриншотами. CX Codex +1 ★ 937звёзд репо scaffold Скилл scaffold для Claude Code изучает структуру и стиль проекта, создаёт новые файлы по похожим примерам и добавляет их в существующие точки регистрации. CX Codex +1 ★ 937звёзд репо houseclean Скилл houseclean для Claude Code проверяет подключённые диски на осиротевшие git worktree, разросшиеся кеши AI-инструментов и пересобираемые артефакты сборки. CX Codex +1 ★ 937звёзд репо pr-watch Скилл pr-watch следит за проверками pull request в терминале, читает логи упавших CI-шагов, правит ошибки и предлагает мерж. CX Codex +1 ★ 937звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой