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

encore-cron — скилл для Claude Code: что делает и как установить

Скилл encore-cron для Claude Code помогает настроить периодические задачи в Encore.ts через CronJob. Запускает ночные выгрузки, очистку баз данных и регулярную агрегацию.

Apache-2.0 476 установок ★ 30 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add encoredev/skills --skill encore-cron -a claude-code
Открыть на GitHub

Что делает 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-code

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

~/.claude/skills/cron/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Бэкенд и API» →
convex-cron-jobs waynesutton Скилл convex-cron-jobs настраивает периодические задачи в convex/crons.ts и отложенный запуск через ctx.scheduler. Помогает разбить мутации на пачки и отладить фоновые очереди. CX Codex +1 2 800установок cron-scheduler rohitg00 Плагин cron-scheduler для настройки cron-задач и проверки расписаний прямо в Claude Code. ★ 2 858звёзд репо crontap-replace-vercel-cron Crontap Скилл crontap-replace-vercel-cron для Claude Code переносит расписание Vercel Cron в Crontap, сохраняя защищённый HTTP-маршрут и план отката. Он запускает расписание через внешний планировщик. CX Codex +1 1 300установок crontap-supabase-edge-function-cron Crontap Скилл crontap-supabase-edge-function-cron для Claude Code настраивает периодический вызов Supabase Edge Functions через внешний планировщик Crontap с повторами при сбоях и журналом запусков. CX Codex +1 1 300установок cron-scheduling claude-dev-suite Скилл cron-scheduling для Claude Code помогает задавать cron-расписания и планировать фоновые задачи в Node.js, Java и Python. Описывает периодические запуски и распределённое планирование. CX Codex +1 162установок Crontab Generator — Natural Language to Cron axel-belfort Crontab Generator — Natural Language to Cron — MCP-сервер для Claude Code переводит словесные описания расписаний в cron-выражения с пояснением и датами запусков. CX Codex +1 4 388установок

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

Весь набор →
encore-go-database Скилл encore-go-database помогает создавать таблицы PostgreSQL, писать миграции и выполнять SQL-запросы в сервисах на Encore Go через пакет sqldb. CX Codex +1 609установок encore-go-code-review Скилл encore-go-code-review проверяет Go-код на Encore: инфраструктура внутри функций, забытый context, SQL-инъекции и другие анти-паттерны перед мержем. CX Codex +1 609установок encore-go-getting-started Скилл encore-go-getting-started проводит от установки Encore CLI до запуска hello-world-приложения на Go и подключения MCP-серверов. Используйте его, когда начинаете проект с нуля. CX Codex +1 575установок encore-secret Скилл encore-secret помогает хранить API-ключи и другие секреты в Encore.ts. Он подсказывает, как объявлять, читать и задавать значения по окружениям. CX Codex +1 477установок encore-pubsub Скилл encore-pubsub помогает строить асинхронный обмен событиями в Encore.ts через Topic и Subscription, включая фоновые обработчики и доставку сообщений. CX Codex +1 474установок encore-bucket Скилл encore-bucket для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — учит агента работать с Bucket из encore.dev/storage/objects. CX Codex +1 474установок encore-cache Скилл encore-cache сохраняет данные в Redis через типизированные keyspace в Encore.ts. Подходит для TTL, счётчиков, временных токенов и горячих чтений. CX Codex +1 473установок encore-webhook Скилл encore-webhook учит агента принимать входящие вебхуки от Stripe, GitHub, Slack и других сервисов через api.raw() и проверять подписи. CX Codex +1 472установок

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

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