read-calendar

读取指定日期范围内的 macOS 日历事件。当用户询问他们的日程安排、即将举行的会议、今天的议程或想知道他们的日历上有什么内容时,请使用此选项。返回事件的时间、地点和参加者。

📖 中文导读:读取指定日期范围内的 macOS 日历事件。当用户询问他们的日程安排、即将举行的会议、今天的议程或想知道他们的日历上有什么内容时,请使用此选项。返回事件的时间、地点和参加者。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: read-calendar description: Read macOS Calendar events for a specified date range. Use this when the user asks about their schedule, upcoming meetings, today's agenda, or wants to know what's on their calendar. Returns events with times, locations, and attendees. allowed-tools: Bash

Read Calendar

Retrieves calendar events from macOS Calendar for analysis, planning, and scheduling.

When to Use

  • "What's on my calendar today?"
  • "Show me my schedule for this week"
  • "Do I have any meetings tomorrow?"
  • "What's my next meeting?"

Requirements

This skill requires icalBuddy to properly handle recurring events: ```bash brew install ical-buddy ```

Instructions

Execute Calendar Read

Use icalBuddy to retrieve events including recurring ones:

```bash icalBuddy -n -iep "title,datetime,location" -df "%Y-%m-%d" -tf "%H:%M" eventsFrom: to: ```

Example: ```bash icalBuddy -n -iep "title,datetime,location" -df "%Y-%m-%d" -tf "%H:%M" eventsFrom:2025-10-26 to:2025-10-27 ```

Note: icalBuddy properly handles recurring events (unlike AppleScript which doesn't pre-generate future instances).

Present Results

Format events clearly:

  • Group by day
  • Show time, title, location, calendar name
  • Highlight conflicts if any
  • Identify gaps for focus time
  • Mark recurring events clearly