convex-monitor — скилл для Claude Code: ждёт ошибку и чинит
Скилл блокируется на следующем событии в приложении Convex — ошибке разработки, ошибке прода или запросе фичи — и передаёт его агенту.
npx skills add convex/agent-skills --skill convex-monitor -a claude-codeЧто делает convex-monitor
Вместо опроса логов агент вызывает wait_for_event с {project_dir, event_kinds, timeout_ms} и ждёт. Гонка идёт между локальными логами ошибок, подписками на деплой и строками ошибок прода из Sentinel, побеждает первое сработавшее событие. Если ничего не произошло, приходит тихий heartbeat.
Дальше всё зависит от типа события. convex_error или next_error — расшифровать и починить. prod_error — разобрать через sentinel и починить. feature_request — собрать. quiet — вернуться в цикл ожидания. Схема событий версионирована, поэтому один и тот же триггер даёт один и тот же типизированный результат.
События прода требуют развёрнутого облачного приложения и Sentinel — без них этот сценарий не заработает. Там, где нет блокирующего MCP, например в облачном Copilot, скилл переходит на цикл опроса с тем же контрактом событий: поведение то же, механизм другой.
Какие задачи решает
- дождаться следующей ошибки в dev-сборке и сразу её починить
- поймать ошибку прода и разобрать её через Sentinel
- не крутить опрос логов вручную, а заблокироваться на событии
- получить запрос на фичу и собрать её в том же цикле
- пережить тихий период без событий и вернуться к ожиданию
Примеры запросов агенту
- вызови wait_for_event для проекта и дождись следующей ошибки
- дождись события prod_error и разбери его через sentinel
- поставь ожидание на feature_request и собери то, что придёт
Как установить convex-monitor
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-monitor -a claude-code2Вручную: положить файлы
~/.claude/skills/convex-monitor/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/convex-monitor/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-monitor -a codex2Вручную: положить файлы
.agents/skills/convex-monitor/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-monitor -a cursor2Вручную: положить файлы
.cursor/skills/convex-monitor/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install convex/agent-skills convex-monitor2Вручную: положить файлы
.github/skills/convex-monitor/SKILL.md1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-monitor -a gemini-cli2Командой платформы
gemini skills install https://github.com/convex/agent-skills --path skills/convex-monitorВручную: положить файлы
.devin/skills/convex-monitor/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-monitor -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о convex-monitor
Как установить convex-monitor в Claude?
Выполните npx skills add convex/agent-skills --skill convex-monitor -a claude-code. После установки скилл лежит в ~/.claude/skills/convex-monitor/SKILL.md.
Что делает convex-monitor?
Блокируется на следующем типизированном событии приложения Convex вместо опроса: ошибке dev или прода либо запросе фичи. Первое сработавшее событие уходит агенту на разбор.
Что нужно для событий прода?
События вида prod_error работают только при развёрнутом облачном приложении и наличии Sentinel. Без них скилл ловит локальные ошибки и запросы.
Исходный текст
SKILL.md · Apache-2.0
---
name: convex-monitor
description: "Watch for the next dev/prod error or request in a Convex app and react to it."
---
<!-- GENERATED from convex-agents content/capabilities/monitor.json — do not edit by hand. -->
# Watch for the next thing to react to
Block on the next typed event instead of polling. Races local error logs, deployment subscriptions, and Sentinel prod-error rows; returns the first to fire (or a quiet heartbeat).
## Workflow
1. Call `wait_for_event` with {project_dir, event_kinds, timeout_ms}.
2. On kind=convex_error/next_error: decode and fix it. On kind=prod_error: triage (see sentinel) and fix. On kind=feature_request: build it. On kind=quiet: loop.
3. Where a harness has no blocking MCP (e.g. Copilot cloud), the pack runs a poll loop with the SAME event contract — same behavior, different mechanism.
## Rules
- Prefer the blocking tool; fall back to a poll loop only where blocking MCP is weak.
- The event schema is fixed and versioned — the same trigger yields the same typed event.
- Prod events (kind=prod_error) require a deployed cloud app plus Sentinel.
© convex · Apache-2.0 · convex/agent-skills
