booking-config — скилл для Claude Code: что делает и как установить
Скилл booking-config для Claude Code настраивает типы встреч, расписания доступности и вебхуки Cal.com через интерфейс агента. Редактирует страницы бронирования без веб-панели.
MIT 103 установок ★ 3 обновлён 2026-10-25
npx skills add terrylica/cc-skills --skill booking-config -a claude-codeЧто делает booking-config
Скилл управляет сервисом Cal.com через локальный бинарник calcom из состава плагина calcom-commander. Агент опрашивает пользователя о параметрах встречи через интерактивный диалог, после чего создаёт или обновляет типы событий, задаёт временные интервалы рабочих дней и запрашивает слоты доступности.
Кроме страниц бронирования, скилл настраивает вебхуки на создание, перенос и отмену встреч. Секреты извлекаются напрямую из 1Password через команду op.
Без установленного CLI-файла по пути $HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli/calcom и переменных CALCOM_OP_UUID и CALCOM_API_URL вызовы сразу завершатся ошибкой.
Какие задачи решает
- Создать новый тип встречи в Cal.com с нужной длительностью
- Задать расписание рабочих часов и временную зону
- Проверить свободные слоты бронирования на выбранные даты
- Зарегистрировать вебхуки Cal.com для внешних уведомлений
Примеры запросов агенту
- Создай страницу бронирования на 30 минут для скрининга кандидатов
- Покажи текущие расписания Cal.com и добавь слоты с 9:00 до 17:00
- Проверь доступность слотов бронирования на следующую неделю
Как установить booking-config
1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill booking-config -a claude-code2Вручную: положить файлы
~/.claude/skills/booking-config/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/booking-config/
1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill booking-config -a codex2Вручную: положить файлы
.agents/skills/booking-config/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill booking-config -a cursor2Вручную: положить файлы
.cursor/skills/booking-config/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install terrylica/cc-skills plugins/calcom-commander/skills/booking-config2Вручную: положить файлы
.github/skills/booking-config/SKILL.md1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill booking-config -a gemini-cli2Командой платформы
gemini skills install https://github.com/terrylica/cc-skills --path plugins/calcom-commander/skills/booking-configВручную: положить файлы
.devin/skills/booking-config/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill booking-config -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о booking-config
Как установить booking-config в Claude Code?
Выполните команду npx skills add terrylica/cc-skills --skill booking-config -a claude-code.
Что делает скилл booking-config?
Он автоматизирует управление Cal.com: создаёт типы встреч, меняет длительность, настраивает рабочие интервалы и регистрирует вебхуки.
Что нужно настроить перед запуском booking-config?
Требуется наличие бинарника calcom в каталоге плагина, установленный 1Password CLI op, а также переменные окружения CALCOM_OP_UUID и CALCOM_API_URL.
Исходный текст
SKILL.md · MIT
---
name: booking-config
description: Cal.com event types, schedules, and availability configuration. TRIGGERS - event type, booking page, schedule
allowed-tools: Read, Bash, Grep, Glob, Write, AskUserQuestion
---
# Booking Configuration
Configure Cal.com event types, schedules, and availability windows via CLI.
> **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 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"
```
### Step 2: Verify Environment
```bash
echo "CALCOM_OP_UUID: ${CALCOM_OP_UUID:-NOT_SET}"
echo "CALCOM_API_URL: ${CALCOM_API_URL:-NOT_SET}"
```
**All must be SET.** If any are NOT_SET, run the setup command first.
### Step 3: Test API Access
```bash
CALCOM_CLI="$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli/calcom"
$CALCOM_CLI event-types list 2>&1 | head -3
```
## Event Type Management
### Create Event Type
Use AskUserQuestion to collect required fields:
```
AskUserQuestion({
questions: [{
question: "What type of booking page do you want to create?",
header: "Event Type",
options: [
{ label: "30-min Meeting", description: "Standard 30-minute meeting slot" },
{ label: "60-min Interview", description: "Full hour interview session" },
{ label: "15-min Quick Call", description: "Brief check-in call" },
{ label: "Custom", description: "Specify custom duration and details" }
],
multiSelect: false
}]
})
```
```bash
CALCOM_CLI="$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli/calcom"
# Create event type with collected details
$CALCOM_CLI event-types create \
--title "30min Interview" \
--slug "interview-30" \
--length 30 \
--description "Screening interview for VA candidates"
```
### Update Event Type
```bash
# Update title
$CALCOM_CLI event-types update <id> --title "Updated Title"
# Update duration
$CALCOM_CLI event-types update <id> --length 45
# Disable event type
$CALCOM_CLI event-types update <id> --hidden true
```
## Schedule Management
### List Schedules
```bash
$CALCOM_CLI schedules list
```
### Create Schedule
```bash
# Create a weekday schedule (9am-5pm)
$CALCOM_CLI schedules create \
--name "Business Hours" \
--timezone "America/New_York" \
--availability '[
{"days": [1,2,3,4,5], "startTime": "09:00", "endTime": "17:00"}
]'
```
### Check Availability
```bash
# Check available slots for a specific date range
$CALCOM_CLI availability check \
--event-type-id <id> \
--start "2026-02-15" \
--end "2026-02-20"
```
## Common Booking Page Patterns
### Candidate Screening Interview
```bash
$CALCOM_CLI event-types create \
--title "VA Screening Interview" \
--slug "va-screening" \
--length 30 \
--description "BruntWork virtual assistant candidate screening" \
--requires-confirmation true
```
### Open Office Hours
```bash
$CALCOM_CLI event-types create \
--title "Office Hours" \
--slug "office-hours" \
--length 15 \
--description "Drop-in office hours for team questions"
```
## Webhook Management
Manage Cal.com webhooks for real-time Pushover notifications via the webhook relay.
### List Webhooks
```bash
CALCOM_API_KEY=$(op item get "$CALCOM_OP_UUID" --vault "Claude Automation" --fields password --reveal)
curl -s "https://api.cal.com/v1/webhooks?apiKey=$CALCOM_API_KEY" | python3 -m json.tool
```
### Register Webhook
```bash
curl -s -X POST "https://api.cal.com/v1/webhooks?apiKey=$CALCOM_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"subscriberUrl\":\"$WEBHOOK_RELAY_URL\",\"eventTriggers\":[\"BOOKING_CREATED\",\"BOOKING_RESCHEDULED\",\"BOOKING_CANCELLED\"],\"active\":true}"
```
### Delete Webhook
```bash
curl -s -X DELETE "https://api.cal.com/v1/webhooks/<webhook-id>?apiKey=$CALCOM_API_KEY"
```
**Prerequisites**: `WEBHOOK_RELAY_URL` must be set in the environment (`~/gh/<org>/<automation-repo>/.env.launchd` for the daemons, or exported in your shell). Deploy the relay first via the `infra-deploy` skill.
## Post-Change Checklist
- [ ] YAML frontmatter valid (no colons in description)
- [ ] Trigger keywords current
- [ ] Path patterns use $HOME not hardcoded paths
## 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