BuilderIO/availability-booking
templates/calendar/.agents/skills/availability-booking/SKILL.md
How the booking system works: checking availability, managing booking links, configuring availability settings, and the public booking URL pattern.
$ install --global
skillsauthnpx skillsauth add BuilderIO/agent-native availability-bookingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 7:43 PM32.4s1 file scanned
SKILL.md
- name:
- availability-booking
- description:
- >-
- How the booking system works:
- checking availability, managing booking links,
Availability & Booking
The calendar app includes a booking system where users can share public URLs for others to book time. Availability is configured per-user, and bookings are stored in SQL via Drizzle ORM.
Availability Settings
Availability is stored in the SQL settings table under the key calendar-availability. It defines which days and time windows the user is available.
{
"timezone": "America/Los_Angeles",
"schedule": {
"monday": [{ "start": "09:00", "end": "17:00" }],
"tuesday": [{ "start": "09:00", "end": "17:00" }],
"wednesday": [{ "start": "09:00", "end": "12:00" }, { "start": "13:00", "end": "17:00" }],
"thursday": [{ "start": "09:00", "end": "17:00" }],
"friday": [{ "start": "09:00", "end": "16:00" }],
"saturday": [],
"sunday": []
}
}
Read via: readSetting("calendar-availability")
Write via: writeSetting("calendar-availability", { ... })
Checking Availability
The check-availability script finds open time slots for a given date by:
- Reading the availability schedule from settings
- Fetching events from Google Calendar for that date
- Computing free slots by subtracting busy intervals from available windows
# Find 30-minute slots on a date
pnpm action check-availability --date 2026-04-05
# Find 60-minute slots
pnpm action check-availability --date 2026-04-05 --duration 60
Required: --date (YYYY-MM-DD format).
Optional: --duration (minimum slot length in minutes, default 30).
Booking Links
Booking links are stored in SQL via Drizzle ORM. Each link has a slug, duration, and associated availability.
The UI manages booking links at /booking-links. The public booking URL pattern is:
/meet/{username}/{slug}
For example: /meet/steve/30min
Bookings
Bookings are the confirmed appointments. They are stored in SQL via Drizzle ORM and visible at /bookings in the UI.
Common Tasks
| User says | What to do |
| -------------------------------------- | -------------------------------------------------------- |
| "Am I free Tuesday at 2pm?" | check-availability --date 2026-04-08 |
| "Find me a 1-hour slot this week" | Check availability for each day this week with --duration 60 |
| "Set my hours to 9-5 weekdays" | Update the calendar-availability setting |
| "Block off Friday afternoons" | Update the Friday schedule to end at 12:00 |
| "Show my bookings" | Navigate to /bookings |
| "Show my booking links" | Navigate to /booking-links |
Important Notes
- Availability settings affect what time slots are offered on public booking pages
- Google Calendar events are checked in real time when computing availability
- All-day events block the entire day
- Bookings create events on Google Calendar when connected
Related Skills
BuilderIO/booker
tools
VerifiedTrustedCommunity
Public booking flow — the state machine, animations, and URL/app-state sync.
108SKILL.mdUpdated Apr 19, 2026
BuilderIO/workflows
tools
VerifiedTrustedCommunity
Trigger-based automations — reminders, follow-ups, webhooks — across the booking lifecycle.
46SKILL.mdUpdated Apr 19, 2026
BuilderIO/team-scheduling
tools
VerifiedTrustedCommunity
Team event types, round-robin assignment, collective bookings, host weights, and no-show calibration.
46SKILL.mdUpdated Apr 19, 2026
BuilderIO/slot-engine
development
VerifiedTrustedCommunity
The pure `computeAvailableSlots` function — inputs, outputs, invariants, and debugging guide.
46SKILL.mdUpdated Apr 19, 2026