--- name: booking-config-a6f491e0b4dd 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 --title "Updated Title" # Update duration $CALCOM_CLI event-types update --length 45 # Disable event type $CALCOM_CLI event-types update --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 \ --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/?apiKey=$CALCOM_API_KEY" ``` **Prerequisites**: `WEBHOOK_RELAY_URL` must be set in the environment (`~/gh///.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. --- Source attribution: terrylica Original project: https://github.com/terrylica/cc-skills/blob/05b229e90559a414af83b5e29fc3bda1f73f8213/plugins/calcom-commander/skills/booking-config/SKILL.md License: MIT License information: https://opensource.org/license/mit Original upstream instructions; downloaded from Dave AI. ## Upstream license notice MIT License Copyright (c) 2025-2026 terrylica Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. # Dave AI resource metadata Creator / publisher: terrylica Original project: https://github.com/terrylica/cc-skills/blob/05b229e90559a414af83b5e29fc3bda1f73f8213/plugins/calcom-commander/skills/booking-config/SKILL.md Attribution basis: Source repository record Fields of work: Operations, Product Management, Sales Roles: Customer Success Manager, Operations Manager, Product Manager Specialties: API, Backend, DevOps, Word Documents, Frontend, Testing Tools: Cal.Com Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 9581d3d69e05085f34629d6ee29d7adc1e83d11a080045c6e206aecc7c3814cd