encore-cron — скилл для Claude Code: что делает и как установить
Скилл encore-cron для Claude Code помогает настроить периодические задачи в Encore.ts через CronJob. Запускает ночные выгрузки, очистку баз данных и регулярную агрегацию.
Apache-2.0 476 установок ★ 30 обновлён 2026-10-23
npx skills add encoredev/skills --skill encore-cron -a claude-codeЧто делает encore-cron
Скилл объясняет агенту, как объявлять фоновые задачи по расписанию через модуль encore.dev/cron. Он привязывает вызов существующего эндпоинта api(...) к интервалу every или классическому cron-выражению schedule. Объявлять CronJob необходимо строго на уровне пакета, а не внутри обработчиков.
Для простых интервалов действует строгое ограничение: значение в every обязано нацело делить 24 часа. Вариант "1h" или "30m" сработает без ошибок, а вот "7h" система не примет. Все временные метки в schedule рассчитываются по UTC. Сам целевой эндпоинт по правилам закрывают параметром { expose: false }, чтобы защитить его от внешних вызовов.
Локально при запуске через encore run крон-задачи вообще не срабатывают. Таймеры запускаются только после деплоя в облачное окружение. Логику обработчика важно делать идемпотентной: при повторном развёртывании сервиса возможны задержки или повторные вызовы.
Какие задачи решает
- настроить ежедневную агрегацию данных в заданное время по UTC
- объявить периодическую очистку таблиц через интервал
every - связать фоновый эндпоинт с планировщиком
CronJobна уровне пакета - скрыть служебный эндпоинт расписания от внешних вызовов через
{ expose: false }
Примеры запросов агенту
- Настрой в Encore.ts ежедневный запуск агрегации заказов в 02:00 UTC через CronJob
- Создай CronJob для очистки устаревших сессий каждые 30 минут
- Добавь еженедельную выгрузку отчётов по воскресеньям в полночь через schedule
Как установить encore-cron
1Через Skills CLI (Vercel)
npx skills add encoredev/skills --skill encore-cron -a claude-code2Вручную: положить файлы
~/.claude/skills/cron/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cron/
1Через Skills CLI (Vercel)
npx skills add encoredev/skills --skill encore-cron -a codex2Вручную: положить файлы
.agents/skills/cron/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add encoredev/skills --skill encore-cron -a cursor2Вручную: положить файлы
.cursor/skills/cron/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install encoredev/skills encore/cron/SKILL.md2Вручную: положить файлы
.github/skills/cron/SKILL.md1Через Skills CLI (Vercel)
npx skills add encoredev/skills --skill encore-cron -a gemini-cli2Командой платформы
gemini skills install https://github.com/encoredev/skills --path encore/cronВручную: положить файлы
.devin/skills/cron/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add encoredev/skills --skill encore-cron -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об encore-cron
Как установить encore-cron в Claude Code?
Выполните команду npx skills add encoredev/skills --skill encore-cron -a claude-code.
Что делает скилл encore-cron?
Он инструктирует ИИ-ассистента по созданию периодических задач CronJob и привязке внутренних API-эндпоинтов в приложениях на Encore.ts.
Почему крон-задачи не запускаются локально?
Планировщик Encore.ts не выполняет задачи при запуске через encore run. Они активируются только в развёрнутых облачных окружениях.
Исходный текст
SKILL.md · Apache-2.0
---
name: encore-cron
description: >-
Schedule periodic / recurring work in Encore.ts using `CronJob` from `encore.dev/cron`. Covers `every: "1h"` interval syntax and `schedule: "0 9 * * 1"` cron expressions.
when_to_use: >-
User wants to run a job on a schedule — anything with the words schedule, scheduled, daily, hourly, weekly, periodic, recurring, every N minutes/hours, "at HH:MM UTC", midnight, batch job, aggregation job, nightly, cleanup job, or background work that runs on a timer rather than in response to a request. Trigger phrases: "every day at 02:00 UTC", "daily aggregation", "run hourly", "scheduled task", "cron", "nightly cleanup", "on a schedule".
---
# Encore Cron Jobs
## Instructions
A `CronJob` declaration in Encore.ts ties a schedule to an existing `api(...)` endpoint. The endpoint runs at the chosen cadence. Declare the `CronJob` at package level — not inside a function.
```typescript
import { CronJob } from "encore.dev/cron";
import { api } from "encore.dev/api";
// 1. The endpoint to call (typically internal: expose: false)
export const aggregateDailyOrders = api(
{ expose: false },
async (): Promise<void> => {
// Aggregation logic
}
);
// 2. Package-level cron declaration
const _ = new CronJob("aggregate-daily-orders", {
title: "Aggregate orders for the previous day",
schedule: "0 2 * * *", // 02:00 UTC every day
endpoint: aggregateDailyOrders,
});
```
## Schedule Formats
| Field | Example | Description |
|---|---|---|
| `every` | `"1h"`, `"30m"`, `"6h"` | Simple interval. **Must divide 24h evenly** — `"7h"` is invalid. |
| `schedule` | `"0 9 * * 1"` | Standard cron expression (5 fields, UTC). |
### Common cron expressions
| Cron | Meaning |
|---|---|
| `"0 * * * *"` | Every hour, on the hour |
| `"0 2 * * *"` | Daily at 02:00 UTC |
| `"0 0 * * 0"` | Weekly on Sunday at midnight UTC |
| `"0 4 15 * *"` | 04:00 UTC on the 15th of each month |
## Important behaviour
- **Cron jobs do not execute when running locally with `encore run`.** Only deployed environments fire crons.
- The cron endpoint should be `expose: false` so it can't be triggered externally — only the cron scheduler should call it.
- All times in `schedule` are UTC. Convert from local time when designing the schedule.
- The endpoint must already exist at module load — declare it before the `CronJob`.
## Guidelines
- Use `every` for "run on a regular interval" (must divide 24h).
- Use `schedule` for specific times of day or days of week.
- Keep endpoint logic idempotent: a cron may fire late or be retried in a redeploy window.
- For event-driven background work (not time-driven), use the `encore-pubsub` skill instead.
© encoredev · Apache-2.0 · encoredev/skills