booking-notify — скилл для Claude Code: уведомления о бронировании
Скилл booking-notify отправляет уведомления о новых бронированиях, отменах и переносах через Telegram и Pushover. Синхронизация каждые 6 часов, вебхук для срочных событий.
MIT 125 установок ★ 3 обновлён 2026-10-25
npx skills add terrylica/cc-skills --skill booking-notify -a claude-codeЧто делает booking-notify
Скилл опрашивает Cal.com API каждые 6 часов через launchd и отправляет изменения в Telegram (HTML-форматированные сообщения с интерактивными командами). Для срочных событий — новое бронирование или перенос — пушит уведомление в Pushover через webhook-ретранслятор на Cloud Run со звуком «dune» и приоритетом emergency, которое требует подтверждения.
Внутри три проверки перед запуском: наличие скрипта синхронизации sync.ts, переменных окружения (CALCOM_OP_UUID, TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID) и собранного бинарника calcom-cli. Если бинарник отсутствует — скрипт соберёт его через bun run build. Pushover опционален: без токенов работает только Telegram-канал.
Скрипт сравнивает текущее состояние с последним известным из файла, детектит новые записи, отмены и переносы, обновляет файл после каждого цикла. Circuit breaker останавливает каскадные сбои при ошибках API.
Какие задачи решает
- получать уведомления о новых бронированиях в двух каналах
- детектить отмены и переносы встреч в Cal.com
- отправить срочное push-уведомление с подтверждением через Pushover
- синхронизировать состояние бронирований каждые 6 часов
Примеры запросов агенту
- Настрой синхронизацию уведомлений о бронированиях через
booking-notify - Проверь переменные окружения для Telegram и Pushover
- Запусти ручную синхронизацию бронирований из Cal.com
Как установить booking-notify
1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill booking-notify -a claude-code2Вручную: положить файлы
~/.claude/skills/booking-notify/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/booking-notify/
1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill booking-notify -a codex2Вручную: положить файлы
.agents/skills/booking-notify/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill booking-notify -a cursor2Вручную: положить файлы
.cursor/skills/booking-notify/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install terrylica/cc-skills plugins/calcom-commander/skills/booking-notify2Вручную: положить файлы
.github/skills/booking-notify/SKILL.md1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill booking-notify -a gemini-cli2Командой платформы
gemini skills install https://github.com/terrylica/cc-skills --path plugins/calcom-commander/skills/booking-notifyВручную: положить файлы
.devin/skills/booking-notify/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill booking-notify -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о booking-notify
Как установить booking-notify в Claude Code?
Выполни npx skills add terrylica/cc-skills --skill booking-notify -a claude-code, затем открой ~/.claude/skills/booking-notify/SKILL.md для настройки переменных окружения.
Что делает booking-notify?
Скилл синхронизирует бронирования из Cal.com каждые 6 часов и отправляет уведомления о новых записях, отменах и переносах в Telegram. Если настроен Pushover — шлёт срочные push-уведомления в реальном времени через webhook.
Что нужно для работы Pushover-канала?
Экспортируй PUSHOVER_APP_TOKEN, PUSHOVER_USER_KEY и разверни webhook-ретранслятор на Cloud Run. Инструкция в pushover-setup.md и webhook-relay.md. Без Pushover скилл работает только через Telegram.
Исходный текст
SKILL.md · MIT
---
name: booking-notify
description: Dual-channel booking notifications via Telegram + Pushover. Scheduled sync, webhook relay, emergency alerts with custom sounds.
allowed-tools: Read, Bash, Grep, Glob
---
# Booking Notifications (Dual-Channel)
Automated booking notifications via two channels:
| Channel | Delivery | Format | Use Case |
| -------- | --------- | ---------- | ------------------------------------------ |
| Telegram | Scheduled | HTML | Interactive commands, daily digest, search |
| Pushover | Real-time | Plain text | Emergency alerts with custom sound (dune) |
> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.
## Mandatory Preflight
### Step 1: Check Sync Script Exists
```bash
ls -la "$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/sync.ts" 2>/dev/null || echo "SCRIPT_NOT_FOUND"
```
### Step 2: Verify Environment (Required)
```bash
echo "CALCOM_OP_UUID: ${CALCOM_OP_UUID:-NOT_SET}"
echo "TELEGRAM_BOT_TOKEN: ${TELEGRAM_BOT_TOKEN:+SET}"
echo "TELEGRAM_CHAT_ID: ${TELEGRAM_CHAT_ID:-NOT_SET}"
echo "HAIKU_MODEL: ${HAIKU_MODEL:-NOT_SET}"
```
**All must be SET.** If any are NOT_SET, run the setup command first.
### Step 3: Verify Pushover (Optional)
```bash
echo "PUSHOVER_APP_TOKEN: ${PUSHOVER_APP_TOKEN:+SET}"
echo "PUSHOVER_USER_KEY: ${PUSHOVER_USER_KEY:+SET}"
echo "PUSHOVER_SOUND: ${PUSHOVER_SOUND:-dune}"
echo "WEBHOOK_RELAY_URL: ${WEBHOOK_RELAY_URL:-NOT_SET}"
```
**If NOT_SET**: Pushover is optional. Telegram-only operation still works. To enable, see [pushover-setup.md](./references/pushover-setup.md).
### Step 4: Verify Cal.com CLI Binary
```bash
ls -la "$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli/calcom" 2>/dev/null || echo "BINARY_NOT_FOUND"
```
**If BINARY_NOT_FOUND**: Build it:
```bash
cd "$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli" && bun install && bun run build
```
## Notification Channels
### Telegram (Scheduled Sync)
6h polling via launchd. Sends HTML-formatted messages for:
| Category | Examples |
| ------------ | ------------------------------------------------ |
| NEW BOOKING | New interview scheduled, new consultation booked |
| CANCELLATION | Booking cancelled by attendee, host cancelled |
| UPCOMING | Booking starting in 1 hour, today's schedule |
| RESCHEDULED | Booking moved to new time, date changed |
### Pushover (Real-Time Webhook)
Instant notifications via Cloud Run webhook relay:
| Event | Priority | Sound | Must Acknowledge? |
| ----------- | ------------- | ----- | ----------------- |
| New booking | 2 (Emergency) | dune | Yes |
| Rescheduled | 2 (Emergency) | dune | Yes |
| Cancelled | 0 (Normal) | dune | No |
### Webhook Relay
The webhook relay is a lightweight Cloud Run service that bridges Cal.com webhooks to Pushover. See [webhook-relay.md](./references/webhook-relay.md) for deployment.
## Running Manually
```bash
cd ~/gh/<org>/<automation-repo> && bun run "$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/sync.ts"
```
## Sync Behavior
1. Fetches bookings from Cal.com API (last 6h window)
2. Compares against last-known state (file-based)
3. Detects new bookings, cancellations, and reschedules
4. Sends Telegram notification (HTML) for each change
5. Sends Pushover notification (plain text) if credentials configured
6. Updates state file for next sync cycle
7. Circuit breaker prevents cascade failures on API errors
## Environment Configuration (Agnostic Wiring)
The scripts read plain environment variables. For the launchd daemons put them in `~/gh/<org>/<automation-repo>/.env.launchd` (sourced by the launcher scripts); for interactive use export them in your shell:
```bash
# Required (Telegram)
export CALCOM_OP_UUID='<1password-uuid>'
export TELEGRAM_BOT_TOKEN='<bot-token>'
export TELEGRAM_CHAT_ID='<chat-id>'
# Optional (Pushover dual-channel)
export PUSHOVER_APP_TOKEN='<pushover-app-token>'
export PUSHOVER_USER_KEY='<pushover-user-key>'
export PUSHOVER_SOUND='dune'
export WEBHOOK_RELAY_URL='https://calcom-pushover-webhook-XXXXX.us-central1.run.app/'
```
## References
- [notification-templates.md](./references/notification-templates.md) — Dual-channel message templates
- [pushover-setup.md](./references/pushover-setup.md) — Pushover credential setup guide
- [webhook-relay.md](./references/webhook-relay.md) — Webhook relay deployment + management
- [sync-config.md](./references/sync-config.md) — Sync interval and state management
## Post-Change Checklist
- [ ] YAML frontmatter valid (no colons in description)
- [ ] Trigger keywords current
- [ ] Path patterns use $HOME not hardcoded paths
- [ ] Pushover graceful degradation verified (works without Pushover creds)
## Post-Execution Reflection
After this skill completes, reflect before closing the task:
0. **Locate yourself.** — Find this SKILL.md's canonical path before editing.
1. **What failed?** — Fix the instruction that caused it.
2. **What worked better than expected?** — Promote to recommended practice.
3. **What drifted?** — Fix any script, reference, or dependency that no longer matches reality.
4. **Log it.** — Evolution-log entry with trigger, fix, and evidence.
Do NOT defer. The next invocation inherits whatever you leave behind.
© terrylica · MIT · terrylica/cc-skills