calcom-access — скилл для Claude Code: управление Cal.com из агента
Скилл calcom-access для Claude Code и пяти других платформ даёт агенту доступ к Cal.com API для работы с бронированиями, типами событий, расписаниями и доступностью слотов. Ключ API берётся из 1Password через CALCOM_OP_UUID.
MIT 107 установок ★ 3 обновлён 2026-10-25
npx skills add terrylica/cc-skills --skill calcom-access -a claude-codeЧто делает calcom-access
Скилл добавляет агенту набор команд для работы с Cal.com API v2: получить список бронирований с фильтром по статусу, создать или изменить тип события, проверить доступные слоты, посмотреть расписание.
Внутри — собственный бинарник calcom на Bun, который скилл собирает сам через bun install && bun run build при первом запуске. Для аутентификации нужен 1Password CLI (op) и переменная CALCOM_OP_UUID с UUID нужного элемента в хранилище. Перед каждой операцией скилл проверяет наличие бинарника, переменной и авторизации в 1Password — если что-то не так, останавливается и объясняет следующий шаг.
Если API-ключа Cal.com ещё нет в 1Password, скилл проведёт по сетапу: найдёт подходящие элементы в хранилище «Claude Automation» или подскажет, как создать новый через op item create. Без активной сессии op signin и без установленного 1Password CLI скилл не запустится.
Какие задачи решает
- Получить список предстоящих бронирований с фильтром по статусу
- Создать тип события с нужным слагом и длительностью
- Проверить свободные слоты через
availability check - Отменить бронирование по ID из агентного пайплайна
- Подключить Cal.com API к агенту через 1Password без хардкода ключей
Примеры запросов агенту
- Покажи все типы событий в моём Cal.com
- Выведи 20 ближайших бронирований со статусом upcoming
- Создай тип события «Встреча 30 минут» со слагом
meeting-30и длительностью 30 минут
Как установить calcom-access
1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill calcom-access -a claude-code2Вручную: положить файлы
~/.claude/skills/calcom-access/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/calcom-access/
1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill calcom-access -a codex2Вручную: положить файлы
.agents/skills/calcom-access/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill calcom-access -a cursor2Вручную: положить файлы
.cursor/skills/calcom-access/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install terrylica/cc-skills plugins/calcom-commander/skills/calcom-access2Вручную: положить файлы
.github/skills/calcom-access/SKILL.md1Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill calcom-access -a gemini-cli2Командой платформы
gemini skills install https://github.com/terrylica/cc-skills --path plugins/calcom-commander/skills/calcom-accessВручную: положить файлы
.devin/skills/calcom-access/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add terrylica/cc-skills --skill calcom-access -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о calcom-access
Как установить calcom-access в Claude Code?
Выполните npx skills add terrylica/cc-skills --skill calcom-access -a claude-code — скилл появится в ~/.claude/skills/calcom-access/SKILL.md.
Что делает скилл calcom-access?
Даёт агенту команды для работы с Cal.com API v2: список и создание бронирований, типов событий и расписаний. Аутентификация идёт через 1Password CLI.
Что нужно для работы calcom-access?
1Password CLI (op) с установленной сессией и переменная CALCOM_OP_UUID со значением UUID нужного API-ключа. Также нужен Bun — скилл собирает CLI-бинарник при первом запуске.
Исходный текст
SKILL.md · MIT
---
name: calcom-access
description: "Access the Cal.com API via CLI with a 1Password API key: bookings, event types, schedules and availability. TRIGGERS - calcom, cal.com, list bookings, event types, create booking page."
allowed-tools: Read, Bash, Grep, Glob, Write, AskUserQuestion
---
# Cal.com Access
Manage Cal.com bookings and event types programmatically via Claude Code.
> **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 (Execute Before Any Cal.com Operation)
**CRITICAL**: You MUST complete this preflight checklist before running any Cal.com commands. Do NOT skip steps.
### Step 1: Check CLI Binary Exists
```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 first:
```bash
cd ~/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli && bun install && bun run build
```
### Step 2: Check CALCOM_OP_UUID Environment Variable
```bash
echo "CALCOM_OP_UUID: ${CALCOM_OP_UUID:-NOT_SET}"
```
**If NOT_SET**: You MUST run the Setup Flow below. Do NOT proceed to Cal.com commands.
### Step 3: Verify 1Password Authentication
```bash
op account list 2>&1 | head -3
```
**If error or not signed in**: Inform user to run `op signin` first.
### Step 4: Test API Connectivity
```bash
CALCOM_CLI="$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli/calcom"
$CALCOM_CLI event-types list 2>&1 | head -5
```
---
## Setup Flow (When CALCOM_OP_UUID is NOT_SET)
Follow these steps IN ORDER. Use AskUserQuestion at decision points.
### Setup Step 1: Check 1Password CLI
```bash
command -v op && echo "OP_CLI_INSTALLED" || echo "OP_CLI_MISSING"
```
**If OP_CLI_MISSING**: Stop and inform user:
> 1Password CLI is required. Install with: `brew install 1password-cli`
### Setup Step 2: Discover Cal.com API Keys in 1Password
```bash
op item list --vault "Claude Automation" --format json 2>/dev/null | jq -r '.[] | select(.title | test("calcom|cal.com|calendar"; "i")) | "\(.id)\t\(.title)"'
```
**Parse the output** and proceed based on results.
### Setup Step 3: User Selects API Credentials
**If items found**, use AskUserQuestion with discovered items.
**If NO items found**, guide the user:
1. Log into the Cal.com instance (self-hosted or cal.com)
2. Go to Settings > Developer > API Keys
3. Generate a new API key with appropriate scopes
4. Store in 1Password Claude Automation vault:
```bash
op item create --category "API Credential" --title "Cal.com API Key" \
--vault "Claude Automation" \
"credential=<api-key>" \
"api_url=<cal.com-instance-url>"
```
### Setup Step 4: Supply the UUID
After user selects an item (with UUID), use AskUserQuestion to confirm where it goes: this shell only (`export CALCOM_OP_UUID=<selected-uuid>`), or the launchd daemons (add `export CALCOM_OP_UUID='<selected-uuid>'` to `~/gh/<org>/<automation-repo>/.env.launchd`, which the launcher scripts source).
### Setup Step 5: Verify
```bash
echo "CALCOM_OP_UUID: ${CALCOM_OP_UUID:-NOT_SET}"
```
### Setup Step 6: Test Connection
```bash
CALCOM_OP_UUID="${CALCOM_OP_UUID}" $HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli/calcom event-types list
```
---
## Cal.com Commands (Only After Preflight Passes)
```bash
CALCOM_CLI="$HOME/.claude/plugins/marketplaces/cc-skills/plugins/calcom-commander/scripts/calcom-cli/calcom"
# List event types
$CALCOM_CLI event-types list
# List bookings
$CALCOM_CLI bookings list -n 10
# List bookings by status
$CALCOM_CLI bookings list --status upcoming -n 20
# Get booking details
$CALCOM_CLI bookings get <booking_id>
# Create event type
$CALCOM_CLI event-types create --title "30min Interview" --slug "interview-30" --length 30
# Update event type
$CALCOM_CLI event-types update <event_type_id> --title "Updated Title"
# List schedules (availability)
$CALCOM_CLI schedules list
# JSON output (for parsing)
$CALCOM_CLI bookings list -n 10 --json
```
## Cal.com API v2 Reference
| Endpoint | CLI Command | Description |
| ------------ | -------------------- | ------------------------- |
| Event Types | `event-types list` | List all event types |
| Event Types | `event-types create` | Create new event type |
| Bookings | `bookings list` | List bookings |
| Bookings | `bookings get` | Get booking details |
| Bookings | `bookings cancel` | Cancel a booking |
| Schedules | `schedules list` | List availability windows |
| Schedules | `schedules create` | Create availability |
| Availability | `availability check` | Check slot availability |
## Environment Variables
| Variable | Required | Description |
| ---------------- | -------- | ----------------------------------- |
| `CALCOM_OP_UUID` | Yes | 1Password item UUID for API key |
| `CALCOM_API_URL` | No | API base URL (default: self-hosted) |
## References
- [calcom-api-setup.md](./references/calcom-api-setup.md) - Cal.com API key setup guide
- [env-setup.md](./references/env-setup.md) - Where each variable comes from, per consumer
## Post-Change Checklist
- [ ] YAML frontmatter valid (no colons in description)
- [ ] Trigger keywords current
- [ ] Path patterns use $HOME not hardcoded paths
- [ ] References exist and are linked
## 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