Availability
ProductivityavailabilityAvailability 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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
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 request | Action |
|---|---|
| "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) |