Skip to content

BuilderIO/agent-native / packages/scheduling/docs/skills/scheduling-basics

scheduling-basics

Unverified

Core concepts of the scheduling package — event types, schedules, bookings, hosts, teams, and how they compose.

Scheduling basics

The mental model:

  • Event Type — a definition of "a bookable thing" (30-minute intro call, 45-minute demo). Lives at /:user/:slug or /team/:teamSlug/:slug.
  • Schedule — a named set of availability rules ("Working Hours", "Evenings"). Weekly intervals plus date-specific overrides. Each user has a default schedule; event types can pick any.
  • Booking — the materialized appointment. Has attendees, references to external systems (Google Calendar event, Zoom meeting), and a stable iCalUID across reschedules.
  • Host — a user assigned to an event type. Hosts have weights and priorities for round-robin.
  • Team — a group of users who can co-host event types.
  • Location — where the meeting happens. Video (built-in, Zoom, Meet, Teams), phone, in-person, or custom link.

Workflows and routing forms

  • Workflow — trigger + ordered steps. "Email attendee 1h before event."
  • Routing Form — pre-booking form with rules that route to the right event type based on answers. Like ChiliPiper.

Public URLs

  • /:user — user profile with event type list
  • /:user/:slug — Booker for a personal event type
  • /:user/:slug/embed — chromeless for iframe embedding
  • /team/:teamSlug — team profile
  • /team/:teamSlug/:slug — Booker for team event type (round-robin or collective)
  • /d/:hash/:slug — private hashed-link Booker
  • /booking/:uid — booking detail / manage
  • /reschedule/:uid — reschedule Booker
  • /forms/:formId — public routing form

Common tasks

User requestAction(s)
"Create a 30-minute intro meeting"create-event-type --title "Intro" --slug intro --length 30
"What's my availability tomorrow?"check-availability --slug <slug> --from ... --to ...
"Cancel my 3pm with Alex"list-bookings --status upcoming, then cancel-booking --uid ...
"Block next Friday"add-date-override --scheduleId <id> --date 2026-04-10 --intervals []
"Connect Google Calendar"connect-calendar --kind google_calendar --redirectUri ...
"Make a team event rotating between Alice and Bob"create-event-type --schedulingType round-robin --teamId ..., then set-event-type-hosts
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 192kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 192kUpdated Claude CodeCodexVerifiedInstall