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