calendar - SKILL.md Agent Skill

name: calendar version: 1.0.0 description: Manage calendar events and schedules author: clawlet requires:

calendar_provider tools:
name: create_event description: Create a new calendar event parameters:
- name: title type: string description: Event title/summary required: true
- name: start_time type: string description: Event start time in ISO 8601 format (e.g., 2024-01-15T10:00:00) required: true
- name: end_time type: string description: Event end time in ISO 8601 format required: true
- name: description type: string description: Event description/notes required: false
- name: location type: string description: Event location required: false
- name: attendees type: string description: Attendee email addresses, comma-separated required: false
- name: reminder_minutes type: integer description: Reminder time in minutes before event required: false default: 15
name: list_events description: List calendar events for a date range parameters:
- name: start_date type: string description: Start date in YYYY-MM-DD format required: true
- name: end_date type: string description: End date in YYYY-MM-DD format required: false
- name: limit type: integer description: Maximum number of events to return required: false default: 20
name: delete_event description: Delete a calendar event parameters:
- name: event_id type: string description: ID of the event to delete required: true
name: find_free_time description: Find available time slots in a date range parameters:
- name: date type: string description: Date to search in YYYY-MM-DD format required: true
- name: duration_minutes type: integer description: Required duration in minutes required: true
- name: working_hours_start type: string description: Start of working hours (HH:MM format) required: false default: "09:00"
- name: working_hours_end type: string description: End of working hours (HH:MM format) required: false default: "17:00"

Calendar Skill

Use this skill to manage calendar events and schedules on behalf of the user.

Usage

When the user asks you to schedule something, use the appropriate tool:

create_event - Create new events
list_events - View upcoming events
delete_event - Remove events
find_free_time - Find available time slots

Examples

"Schedule a meeting with John tomorrow at 2pm"
"What's on my calendar next week?"
"Find a 30-minute slot for a call on Friday"
"Cancel my 3pm meeting"

Configuration Required

Before using this skill, ensure the following configuration is set:

skills:
  calendar:
    calendar_provider: "google"  # or "outlook", "caldav"
    # Provider-specific settings:
    google_client_id: "your-client-id"
    google_client_secret: "your-client-secret"

Date/Time Handling

All times should be in ISO 8601 format
Dates should be in YYYY-MM-DD format
The skill will use the user's configured timezone

Limitations

Recurring events are not yet fully supported
Maximum 100 attendees per event
Free time search only considers working hours by default

Tips

Always confirm event details before creating
Suggest times based on free time search
Include relevant details in event descriptions