# crontap-recurring-agent-endpoint

Ставит HTTP-эндпоинт вашего приложения на внешнее расписание Crontap и следит за завершением через heartbeat. Нужен, когда у агента уже есть свой рантайм, а своего таймера нет.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 880 установок · ★ 1
- Автор: Crontap
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/Crontap/skills/tree/HEAD/skills/crontap-recurring-agent-endpoint/SKILL.md
- Обновлён: 2026-09-16
- HTML: https://affpapa.org/nevibecode/skills/crontap-recurring-agent-endpoint

## Что делает

Скилл описывает архитектуру, в которой Crontap шлёт HTTP-запрос на защищённый эндпоинт приложения, приложение кладёт задачу в свою очередь, а воркер выполняет работу и после успешного завершения пингует heartbeat. Сам Crontap агентов не будит: ни сессии IDE, ни чаты, ни MCP-клиенты он не запускает. Для повторяющегося промпта внутри Cursor, Claude, ChatGPT или Codex берите встроенную автоматизацию клиента.

Внутри пять шагов: создать heartbeat с периодом и запасом под ожидаемое время выполнения, положить его секретный URL в хранилище секретов воркера, научить воркер пинговать только после устойчивого успеха и звать `/fail` при явном провале, завести расписание на эндпоинт постановки в очередь, затем проверить три вида доказательств — постановку, работу воркера и пинги. Инструменты называются `create_schedule`, `create_heartbeat` и `get_heartbeat_pings`.

Перед первым вызовом скилл требует выбрать способ доступа: либо подключить Crontap MCP по адресу `https://mcp.crontap.com/mcp`, либо задать `$CRONTAP_CLIENT_ID` и `$CRONTAP_API_KEY` для сырого API. Второй путь доступен только на тарифе Ultra, MCP работает на всех. Без выбранного пути работа не продолжается. Эндпоинт обязан аутентифицировать запрос до чтения тела, отвечать 2xx только после приёма задачи в очередь и держать ключи модели внутри воркера.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Crontap/skills --skill crontap-recurring-agent-endpoint -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/crontap-recurring-agent-endpoint/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/crontap-recurring-agent-endpoint/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Crontap/skills --skill crontap-recurring-agent-endpoint -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/crontap-recurring-agent-endpoint/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Crontap/skills --skill crontap-recurring-agent-endpoint -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/crontap-recurring-agent-endpoint/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Crontap/skills crontap-recurring-agent-endpoint
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/crontap-recurring-agent-endpoint/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Crontap/skills --skill crontap-recurring-agent-endpoint -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Crontap/skills --path skills/crontap-recurring-agent-endpoint
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/crontap-recurring-agent-endpoint/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Crontap/skills --skill crontap-recurring-agent-endpoint -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Crontap/skills/tree/HEAD/skills/crontap-recurring-agent-endpoint/SKILL.md

## Когда брать
- запускать повторяющийся рабочий процесс агента по внешнему расписанию
- узнавать, что запланированный запуск не дошёл до конца
- защитить эндпоинт постановки задач отдельным cron-секретом
- не плодить дубли при ретраях воркера
- отличить успешную постановку в очередь от реального завершения

## Примеры запросов агенту
- Настрой heartbeat на сутки с запасом в час и расписание, которое каждый день в 07:00 шлёт POST на наш эндпоинт
- Покажи пинги heartbeat за 2026-09-14
- Проверь, что воркер пингует только после успешного завершения, а при провале зовёт `/fail`

## Похожие
- [recipe-schedule-recurring-event](https://affpapa.org/nevibecode/skills/recipe-schedule-recurring-event.md) — скилл · 30200 установок
- [cyrus-setup-endpoint](https://affpapa.org/nevibecode/skills/cyrus-setup-endpoint.md) — скилл · 1000 установок
- [agent-platform-endpoint-management](https://affpapa.org/nevibecode/skills/agent-platform-endpoint-management.md) — скилл · 8086 установок
- [endpoint-ops](https://affpapa.org/nevibecode/skills/endpoint-ops.md) — скилл · 2700 установок
- [paperclip](https://affpapa.org/nevibecode/skills/paperclip.md) — скилл · 3800 установок
- [inngest-api](https://affpapa.org/nevibecode/skills/inngest-api.md) — скилл · 783 установки

Из того же набора: [crontap/skills](https://affpapa.org/nevibecode/by/crontap/skills.md) — 6 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md