calendar
Calendar canvas for displaying events and picking meeting times.Use when showing calendar views or when users need to select available time slots.
When & Why to Use This Skill
This Claude skill provides an interactive calendar canvas designed to streamline meeting scheduling and event visualization. It enables users to display complex schedules, overlay multiple calendars for availability checks, and interactively select optimal meeting times with configurable granularity, significantly reducing the friction of coordination and improving scheduling efficiency.
Use Cases
- Team Coordination: Overlay multiple team members' calendars with distinct color coding to instantly identify shared free slots for group meetings or syncs.
- Interactive Meeting Selection: Enable users to visually browse availability and click to select specific time slots directly on a timeline, returning precise ISO-formatted start and end times.
- Schedule Visualization: Display weekly event overviews with intuitive navigation (keyboard shortcuts and mouse support) for a clear view of upcoming commitments and deadlines.
- Customizable Appointment Booking: Configure specific slot granularities (15, 30, or 60 minutes) and set minimum/maximum duration constraints to ensure scheduled meetings meet specific business requirements.
| name | calendar |
|---|---|
| description | | |
Calendar Canvas
Display calendar views and enable interactive meeting time selection.
Scenarios
display (default)
View-only calendar display. User can navigate weeks but cannot select times.
bun run src/cli.ts show calendar --scenario display --config '{
"title": "My Week",
"events": [
{"id": "1", "title": "Meeting", "startTime": "2025-01-06T09:00:00", "endTime": "2025-01-06T10:00:00"}
]
}'
meeting-picker
Interactive scenario for selecting a free time slot when viewing multiple people's calendars.
- Shows multiple calendars overlaid with different colors
- User can click on free slots to select a meeting time
- Selection is sent back via IPC
- Supports configurable time slot granularity (15/30/60 min)
bun run src/cli.ts spawn calendar --scenario meeting-picker --config '{
"calendars": [
{
"name": "Alice",
"color": "blue",
"events": [
{"id": "1", "title": "Standup", "startTime": "2025-01-06T09:00:00", "endTime": "2025-01-06T09:30:00"}
]
},
{
"name": "Bob",
"color": "green",
"events": [
{"id": "2", "title": "Call", "startTime": "2025-01-06T14:00:00", "endTime": "2025-01-06T15:00:00"}
]
}
],
"slotGranularity": 30,
"minDuration": 30,
"maxDuration": 120
}'
Configuration
Display Config
interface CalendarConfig {
title?: string;
events: CalendarEvent[];
}
interface CalendarEvent {
id: string;
title: string;
startTime: string; // ISO datetime
endTime: string; // ISO datetime
color?: string; // blue, green, red, yellow, magenta, cyan
}
Meeting Picker Config
interface MeetingPickerConfig {
calendars: Calendar[];
slotGranularity?: number; // 15, 30, or 60 minutes (default: 30)
minDuration?: number; // Minimum meeting duration in minutes
maxDuration?: number; // Maximum meeting duration in minutes
}
interface Calendar {
name: string; // Person's name
color: string; // Calendar color
events: CalendarEvent[]; // Their busy times
}
Controls
Display scenario:
←/→orh/l: Navigate between daysnorPageDown: Next weekporPageUp: Previous weekt: Jump to todayqorEsc: Quit
Meeting picker scenario:
- Mouse click: Select a free time slot
←/→: Navigate weekst: Jump to todayqorEsc: Cancel selection
Selection Result
interface MeetingSelection {
startTime: string; // ISO datetime
endTime: string; // ISO datetime
duration: number; // Minutes
}
API Usage
import { pickMeetingTime } from "${CLAUDE_PLUGIN_ROOT}/src/api";
const result = await pickMeetingTime({
calendars: [
{ name: "Alice", color: "blue", events: [...] },
{ name: "Bob", color: "green", events: [...] },
],
slotGranularity: 30,
});
if (result.success && result.data) {
console.log(`Selected: ${result.data.startTime} - ${result.data.endTime}`);
}