Team Scheduling
Productivityteam-schedulingTeam Scheduling 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.
Team event types, round-robin assignment, collective bookings, host weights, and no-show calibration.
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/team-scheduling/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/team-scheduling, 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.
Team scheduling
Scheduling types
- Collective — all selected team members must be free; booking lists all as organizers.
- Round-robin — one team member is chosen per booking by a rotation strategy.
- Managed — parent event type pushed to member-level children (advanced; stub in v1).
Round-robin strategies
| Strategy | How |
|---|---|
lowest-recent-bookings | (Default) host with fewest bookings in past 30d wins; tiebreak by priority, then weight, then email |
weighted | Weighted random pick; deterministic given the same seed |
calibrated | Weighted with no-show penalty (hosts with high no-show rates get fewer) |
Hosts
Rows in event_type_hosts: {userEmail, isFixed, weight, priority, scheduleId?}. Fixed hosts always attend (like collective within a
round-robin set). Weight scales the relative share. Priority (lower =
higher) breaks ties.
Host schedule override
Normally each host's default schedule is used for their slots. A
per-event-type-per-host override is possible via
set-host-availability-override.
Out-of-office
OOO hosts are auto-excluded from round-robin for the duration of the OOO
window. Bookings can redirect to the OOO's redirectUserEmail.
Host groups
event_type_host_groups lets you split hosts into groups — useful for
"collective within each group, round-robin across groups".
Common tasks
| User | Action |
|---|---|
| "Make a sales demo that rotates Alice / Bob / Carol" | create-event-type --schedulingType round-robin --teamId ..., then set-event-type-hosts |
| "Add Dave as a fixed host" | set-event-type-hosts with Dave as isFixed: true |
| "Stop routing to Alice while she's on PTO" | Insert an out_of_office_entries row for Alice's range |