Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Productivity

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 calendar

About 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 container
  • VERSION - iCalendar version (always 2.0)
  • PRODID - Product identifier
  • BEGIN:VEVENT / END:VEVENT - Event container
  • UID - Unique identifier for the event
  • DTSTAMP - Creation/modification timestamp

Common Fields

  • SUMMARY - Event title
  • DTSTART - Start date/time
  • DTEND - End date/time (or use DURATION)
  • DESCRIPTION - Event details
  • LOCATION - Where the event takes place
  • ORGANIZER - Event organizer (email format: mailto:user@domain.com)
  • ATTENDEE - Event participants (can have multiple)
  • STATUS - TENTATIVE, CONFIRMED, or CANCELLED
  • TRANSP - 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 day
  • WEEKLY - Every week
  • MONTHLY - Every month
  • YEARLY - Every year

Common Parameters

  • INTERVAL=n - Every n periods (e.g., INTERVAL=2 for every 2 weeks)
  • COUNT=n - Number of occurrences
  • UNTIL=date - End date for recurrence
  • BYDAY=MO,TU,WE,TH,FR - Days of the week
  • BYMONTHDAY=1,15 - Days of the month
  • BYDAY=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 event
  • PT15M - 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 ↗