convex-crons — скилл для Claude Code: что делает и как установить
Добавляет периодические фоновые задачи через crons в приложение на Convex. Пригодится, когда нужно настроить регулярное обслуживание базы или очистку данных.
npx skills add convex/agent-skills --skill convex-crons -a claude-codeЧто делает convex-crons
Скилл настраивает периодические задачи в файле convex/crons.ts с помощью функции cronJobs(). Он учит агента создавать вызовы только для внутренних функций пространства internal.*, исключая публичные api.*.
Каждое задание проектируется компактным и идемпотентным. Это защищает систему при сбоях и повторных запусках. После настройки агент проверяет появление задачи в панели управления Convex.
Правила скилла прямо запрещают частый опрос там, где реактивная подписка Convex способна сама передать обновления клиенту.
Какие задачи решает
- создать файл
convex/crons.tsс расписанием задач - привязать функции
internal.*к интервалам выполнения - настроить идемпотентный фоновый обработчик для базы данных
- проверить фоновые задания в панели управления Convex
Примеры запросов агенту
- Настрой в Convex регулярную очистку сессий раз в сутки через convex/crons.ts
- Добавь фоновую задачу для вызова internal.archiveLogs каждый час
Как установить convex-crons
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-crons -a claude-code2Вручную: положить файлы
~/.claude/skills/convex-crons/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/convex-crons/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-crons -a codex2Вручную: положить файлы
.agents/skills/convex-crons/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-crons -a cursor2Вручную: положить файлы
.cursor/skills/convex-crons/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install convex/agent-skills convex-crons2Вручную: положить файлы
.github/skills/convex-crons/SKILL.md1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-crons -a gemini-cli2Командой платформы
gemini skills install https://github.com/convex/agent-skills --path skills/convex-cronsВручную: положить файлы
.devin/skills/convex-crons/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-crons -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о convex-crons
Как установить convex-crons в Claude Code?
Выполните команду npx skills add convex/agent-skills --skill convex-crons -a claude-code.
Что делает скилл convex-crons?
Он помогает создавать периодические задачи в convex/crons.ts, связывая их с внутренними функциями Convex и задавая интервалы повтора.
Какие функции разрешено вызывать в расписании Convex?
Скилл требует запускать исключительно функции из пространства internal.*. Использовать публичные функции api.* для cron-задач запрещено.
Исходный текст
SKILL.md · Apache-2.0
--- name: convex-crons description: "Add recurring scheduled jobs (crons) to the Convex app." --- <!-- GENERATED from convex-agents content/capabilities/crons.json — do not edit by hand. --> # Add scheduled jobs (crons) Define recurring jobs in convex/crons.ts targeting internal functions, with sane intervals and idempotent handlers. ## Workflow 1. Create convex/crons.ts with cronJobs(). 2. Schedule internal functions (never public api.*) at the right interval. 3. Make handlers idempotent (safe to re-run); keep each run small. 4. Verify the job appears in the dashboard schedule. ## Rules - Schedule internal.* functions, never api.*. - Keep cron handlers small + idempotent. - Don't poll tight intervals for things a subscription can push.
© convex · Apache-2.0 · convex/agent-skills