calendar

Display calendar views and enable interactive meeting time slot selection via CLI.

2|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/ghoshsam/claude-code-skills --skill calendar-ghoshsam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: calendar
Source: https://github.com/ghoshsam/claude-code-skills/tree/main/skills/canvas/calendar
Command: npx skills add https://github.com/ghoshsam/claude-code-skills --skill calendar-ghoshsam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating meeting times across multiple people's schedules requires manually comparing calendars, which is slow and error-prone. This Skill renders calendar views in a terminal canvas and lets users visually pick free time slots across multiple overlaid calendars. ## Core Features & Use Cases - View-Only Calendar Display: Render a weekly calendar with events, navigable by day or week via keyboard controls. - Interactive Meeting Picker: Overlay multiple people's calendars with distinct colors and click free slots to select a meeting time, with configurable slot granularity (15/30/60 minutes) and duration limits. - Programmatic API: Use the pickMeetingTime API to capture the selected time slot as structured data (start time, end time, duration) returned via IPC. - Use Case: Ask the assistant to find a time when Alice and Bob are both free next week; the Skill spawns a meeting-picker canvas showing both calendars, and your click selection is returned as an ISO datetime range. ## Quick Start Ask the assistant to show your calendar for this week or to find a 30-minute slot when two teammates are both available.

Frequently Asked Questions about calendar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I display a calendar view in the terminal?▼

Run the CLI with the display scenario, passing a config containing a title and an array of events with ISO start and end times. The calendar renders in a canvas where you can navigate days and weeks using keyboard controls.

How do I pick a meeting time across multiple calendars?▼

Use the meeting-picker scenario with a config listing each person's name, color, and busy events. The canvas overlays all calendars, and clicking a free slot returns the selected start time, end time, and duration.

Can I configure the meeting slot granularity and duration?▼

Yes, the meeting picker accepts slotGranularity of 15, 30, or 60 minutes, plus minDuration and maxDuration values in minutes. These constrain which time slots can be selected.

How do I get the selected meeting time programmatically?▼

Import pickMeetingTime from the plugin's API module and pass the calendars configuration. The returned result contains a data object with startTime and endTime as ISO datetimes and duration in minutes.

What keyboard controls does the calendar canvas support?▼

Use arrow keys or h/l to navigate days, n/PageDown and p/PageUp for weeks, t to jump to today, and q or Esc to quit. In meeting-picker mode, mouse clicks select free slots.