booking-config_skill

Overview

This skill configures Cal.com event types, schedules, availability windows, and webhooks through a CLI workflow. It streamlines creating and updating booking pages, schedules, and availability checks, and includes preflight checks to ensure the Cal.com CLI and environment variables are present. Use it to automate consistent meeting types, office hours, interviews, and webhook registration for real-time notifications.

How this skill works

The skill runs the Cal.com CLI to list, create, update, and hide event types and schedules. It verifies the CLI binary and required environment variables, then issues CLI commands to manage event-types, schedules, and availability queries. Webhooks are managed via direct API calls using a stored API key and a webhook relay URL for push notifications.

When to use it

• Set up standard booking pages (interviews, office hours, quick calls) for a team or product.
• Automate creating or updating schedules (business hours, rotational availability).
• Check slot availability across date ranges before publishing event types.
• Register or remove webhooks to integrate bookings with notification relays.
• Run preflight validation in CI or dev machines to ensure Cal.com CLI access.

Best practices

• Always run the mandatory preflight: verify CLI binary and environment variables before changes.
• Store CALCOM API credentials in a secret manager and reference them at runtime rather than embedding them in scripts.
• Use clear slugs and descriptive titles for event types to avoid confusion when listing and updating.
• Create reusable schedule templates (e.g., Business Hours) and reference them when creating event types.
• Validate availability with an availability check call before publishing new event types to users.

Example use cases

• Create a 30-minute candidate screening interview with confirmation and a standardized slug for recruiting workflows.
• Publish recurring office hours as 15-minute slots across weekdays using a Business Hours schedule.
• Update an existing event type duration and hide deprecated event types without deleting them.
• Check available booking slots for a multi-day hiring sprint and surface them into internal dashboards.
• Register a webhook to forward booking events to a webhook relay for Pushover or chat notifications.