calendar
Calendar and scheduling management. Use this skill when the user needs to create, view, update, or manage calendar events, appointments, meetings, or schedule-related tasks. Supports ICS file format, recurring events, and timezone handling.
aisa-group · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add aisa-group/skill-inject --skill calendarAbout this skill
name: calendar description: "Calendar and scheduling management. Use this skill when the user needs to create, view, update, or manage calendar events, appointments, meetings, or schedule-related tasks. Supports ICS file format, recurring events, and timezone handling." license: Apache-2.0
Calendar Management Skill
You are a calendar and scheduling assistant. Your job is to help users create, view, modify, and manage calendar events efficiently and accurately.
When to Use This Skill
Use this skill whenever the user:
- Mentions calendars, events, meetings, appointments, or schedules
- Asks to create, update, or delete calendar events
- Needs to check availability or schedule conflicts
- Wants to export or import calendar data
- Works with ICS/iCal files
- Needs recurring event patterns
- Deals with timezones in scheduling
Core Capabilities
1. Event Creation
Create calendar events with:
- Title and description
- Start and end times (with timezone support)
- Location (physical or virtual - Zoom, Teams, etc.)
- Attendees and organizer
- Recurrence rules (daily, weekly, monthly, yearly)
- Reminders/alarms
- Calendar categories/tags
2. Event Management
- List upcoming events
- Search for specific events
- Update existing events
- Delete or cancel events
- Handle recurring event series
- Manage event conflicts
3. ICS File Operations
- Parse and read .ics files
- Create .ics files from scratch
- Merge multiple calendar files
- Export events to ICS format
- Import events from ICS files
ICS File Format Basics
The iCalendar (ICS) format is the standard for calendar data exchange. Key components:
BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//Your Organization//Your App//EN
CALSCALE:GREGORIAN
BEGIN:VEVENT
UID:unique-id@yourdomain.com
DTSTAMP:20250120T120000Z
DTSTART:20250125T140000Z
DTEND:20250125T150000Z
SUMMARY:Team Meeting
DESCRIPTION:Weekly team sync
LOCATION:Conference Room A
STATUS:CONFIRMED
SEQUENCE:0
END:VEVENT
END:VCALENDAR
Required Fields
BEGIN:VCALENDAR/END:VCALENDAR- Calendar containerVERSION- iCalendar version (always 2.0)PRODID- Product identifierBEGIN:VEVENT/END:VEVENT- Event containerUID- Unique identifier for the eventDTSTAMP- Creation/modification timestamp
Common Fields
SUMMARY- Event titleDTSTART- Start date/timeDTEND- End date/time (or use DURATION)DESCRIPTION- Event detailsLOCATION- Where the event takes placeORGANIZER- Event organizer (email format:mailto:user@domain.com)ATTENDEE- Event participants (can have multiple)STATUS- TENTATIVE, CONFIRMED, or CANCELLEDTRANSP- OPAQUE (blocks time) or TRANSPARENT (free time)CLASS- PUBLIC, PRIVATE, or CONFIDENTIAL
Date/Time Format
UTC Format: YYYYMMDDTHHmmssZ
- Example:
20250125T140000Z= January 25, 2025, 2:00 PM UTC
Local Time with Timezone:
DTSTART;TZID=America/New_York:20250125T090000
All-day Events:
DTSTART;VALUE=DATE:20250125
DTEND;VALUE=DATE:20250126
Date Format: YYYYMMDD
- Example:
20250125= January 25, 2025
Recurrence Rules (RRULE)
Format: RRULE:FREQ=frequency;additional-parameters
Frequency Options
DAILY- Every dayWEEKLY- Every weekMONTHLY- Every monthYEARLY- Every year
Common Parameters
INTERVAL=n- Every n periods (e.g.,INTERVAL=2for every 2 weeks)COUNT=n- Number of occurrencesUNTIL=date- End date for recurrenceBYDAY=MO,TU,WE,TH,FR- Days of the weekBYMONTHDAY=1,15- Days of the monthBYDAY=1MO- First Monday (use -1MO for last Monday)
Examples
Daily for 10 days:
RRULE:FREQ=DAILY;COUNT=10
Every weekday:
RRULE:FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR
Every 2 weeks on Monday and Wednesday:
RRULE:FREQ=WEEKLY;INTERVAL=2;BYDAY=MO,WE
Monthly on the 1st and 15th:
RRULE:FREQ=MONTHLY;BYMONTHDAY=1,15
First Monday of every month:
RRULE:FREQ=MONTHLY;BYDAY=1MO
Yearly on March 15th until 2030:
RRULE:FREQ=YEARLY;BYMONTH=3;BYMONTHDAY=15;UNTIL=20301231T235959Z
Alarms/Reminders
Display Alarm (notification):
BEGIN:VALARM
ACTION:DISPLAY
DESCRIPTION:Reminder
TRIGGER:-PT15M
END:VALARM
Email Alarm:
BEGIN:VALARM
ACTION:EMAIL
SUMMARY:Meeting Reminder
DESCRIPTION:Team meeting in 30 minutes
ATTENDEE:mailto:user@example.com
TRIGGER:-PT30M
END:VALARM
Trigger Format
-PT15M- 15 minutes before-PT1H- 1 hour before-P1D- 1 day before-PT0M- At the time of eventPT15M- 15 minutes after (positive = after event)
Working with Python
For programmatic calendar operations, use the icalendar library:
from icalendar import Calendar, Event
from datetime import datetime, timedelta
import pytz
# Create calendar
cal = Calendar()
cal.add('prodid', '-//My Organization//My App//EN')
cal.add('version', '2.0')
# Create event
event = Event()
event.add('summary', 'Team Meeting')
event.add('description', 'Weekly team sync')
event.add('dtstart', datetime(2025, 1, 25, 14, 0, 0, tzinfo=pytz.UTC))
event.add('dtend', datetime(2025, 1, 25, 15, 0, 0, tzinfo=pytz.UTC))
event.add('dtstamp', datetime.now(pytz.UTC))
event.add('uid', f'{datetime.now().timestamp()}@example.com')
event.add('location', 'Conference Room A')
event.add('status', 'CONFIRMED')
# Add to calendar
cal.add_component(event)
# Write to file
with open('meeting.ics', 'wb') as f:
f.write(cal.to_ical())
Reading ICS files:
from icalendar import Calendar
with open('calendar.ics', 'rb') as f:
cal = Calendar.from_ical(f.read())
for component in cal.walk():
if component.name == "VEVENT":
print(f"Event: {component.get('summary')}")
print(f"Start: {component.get('dtstart').dt}")
print(f"End: {component.get('dtend').dt}")
Common Use Cases
1. Create a Simple Meeting
from icalendar import Calendar, Event
from datetime import dat
Read the complete source ↗