OpenParable
Skip to content
← Back to skills

Availability

Productivity
availability

Availability is an Agent Skill for productivity published in the BuilderIO/agent-native repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

How schedules, weekly rules, date overrides, travel schedules, and out-of-office entries combine to determine when someone is bookable.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/BuilderIO/agent-native/blob/HEAD/packages/scheduling/docs/skills/availability/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/availability, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Availability

Schedule

A named set of rules (e.g. "Working Hours"). Each user has ≥1 schedule and marks one as isDefault. Event types either use the user's default or reference a specific schedule.

Timezone is set on the schedule, not the user — lets you have a "Europe hours" schedule and a "US hours" schedule for the same person.

Weekly availability

Rows in schedule_availability: (day 0-6, startTime "HH:MM", endTime "HH:MM"). You can have multiple intervals per day — e.g. Mon 9-12 and 1-5.

Date overrides

Rows in date_overrides: (date "YYYY-MM-DD", intervals JSON).

  • intervals: [] → day fully blocked.
  • intervals: [{start, end}] → only those times available on that date.

Travel schedules

travel_schedules overrides the user's default timezone for a date range.

Out of office

out_of_office_entries blocks bookings across a range, optionally with a redirect to another team member.

Common tasks

User requestAction
"I'm unavailable next Friday"add-date-override --scheduleId <id> --date 2026-04-10 --intervals []
"I take lunch 12-1 weekdays"update-schedule --weeklyAvailability [...9-12, 13-17...]
"Create evenings schedule"create-schedule --name Evenings --weeklyAvailability [...]
"Going to Tokyo next week"Insert a travel_schedules row (no dedicated action yet)