Skip to content

ericrisco/rsc-harness / skills/calendar-scheduling

calendar-scheduling

Verified

Use when a product needs a booking surface — a pick-a-slot page, a Cal.com/Calendly embed, or real availability plus the confirmed meeting written to Google/Outlook — or when fixing double-booking, DST drift, or orphaned reschedule events. NOT calendar CRUD with no booking surface (that is `google-workspace`), NOT the payment (that is `stripe`).

FileKindSize
SKILL.mdskill md10.3 KB
evals/README.mdmarkdown899 B
evals/cases.yamlconfig3.3 KB
references/google-calendar-sync.mdmarkdown3.1 KB
references/provider-matrix.mdmarkdown3.5 KB
scripts/verify.shexecutablescript4.6 KB

references/provider-matrix.md

View on GitHub
# Provider matrix — which scheduling stack wins when

Facts dated 2026-06-02. Pick by what you must *own*, not by brand familiarity.

## Cal.com

- **Hosting:** open-source, cloud or **self-hostable**. Self-host = full
  white-label (point the embed script at your own domain, zero Cal.com brand)
  and **unlimited API access** — no cloud rate limit to design around.
- **REST API:** base `https://api.cal.com/v2`. `POST /v2/bookings` creates
  regular, recurring, and instant bookings with attendee info, metadata, and
  booking-field responses.
- **Booking surfaces:** (a) **embed** — inline / button / modal triggers,
  identical on cloud and self-hosted; (b) **Booker atom** — an open-source
  modular component for a fully custom booking UI inside your app; (c) the v2
  API for headless booking.
- **Webhooks:** `BOOKING_CREATED` / `BOOKING_CANCELLED` / `BOOKING_RESCHEDULED`
  (plus more). Verify the signature; dedupe on the booking id.
- **Wins when:** you want OSS / self-host / white-label, or you need a custom UI
  (atom) without owning calendar sync, or you want no rate-limit anxiety.

## Calendly

- **Auth:** OAuth 2.1 or personal access token. **v1 API and v1 webhooks were
  discontinued in May 2025** — v2 only for new work (REST, JSON).
- **Scheduling API:** the Create Event Invitee endpoint books meetings via API
  with **no redirect / iframe / hosted UI** — headless booking.
- **Single-use scheduling links expire after 90 days** if unused.
- **Webhooks:** `invitee.created`, `invitee.canceled`, and routing-form
  submissions. Scoped `user` or `organization`. **Require a paid plan**
  (Standard / Teams / Enterprise).
- **Wins when:** the org already runs Calendly and you want API booking + events
  without standing up your own scheduler.

## Google Calendar (direct, single provider)

- **Availability:** `freebusy.query` (POST) returns busy blocks per calendar.
- **Write:** `events.insert` (add `conferenceData` to attach a Meet link).
- **Scopes:** `calendar` / `calendar.events` are **restricted** (require a
  third-party security assessment for production). Prefer granular:
  `calendar.app.created`, `calendar.freebusy`, `calendar.events.freebusy`,
  `calendar.events.owned`, `calendar.readonly`.
- **What you own:** OAuth, token refresh, `watch` push channels, incremental
  sync via sync tokens, recurring-event edge cases.
- **Wins when:** one provider, you need direct read/write, and you accept owning
  the integration. Pure CRUD with no booking surface → use `google-workspace`.

## Nylas v3 (unified)

- **Coverage:** Google + Outlook/Exchange + Apple/iCloud behind one API, with
  availability and free/busy endpoints.
- **Caveat:** **domain-scoped** — availability queries are restricted within an
  organization, so **cross-company scheduling needs multiple external calls**.
- **Wins when:** multi-provider but single-org scheduling is fine and you don't
  want to maintain three integrations.

## Cronofy (unified)

- **Coverage:** Google + Outlook/Exchange + Apple/iCloud behind one API.
- **No domain restriction:** a single call can span domains; caches free/busy in
  a Sync Engine.
- **Wins when:** multi-provider AND **cross-domain** scheduling matters (booking
  across companies in one availability call).

## Quick chooser

- Fastest page, no UI work → Cal.com / Calendly **embed**.
- Own UI + own data model → Cal.com **Booker atom** or **Scheduling API**.
- One provider, direct control → **Google direct** (`freebusy.query` + `events.insert`).
- Many providers, single org → **Nylas v3**.
- Many providers, cross-domain → **Cronofy**.
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall