calendar_skill

Overview

This skill integrates Google Calendar through the AtrisOS API to view, create, update, and delete calendar events. It provides ready-to-run bootstrap checks for authentication and connection, and exposes simple HTTP endpoints for common calendar operations. Use it to let an agent answer schedule questions and manage meetings on the user's calendar.

How this skill works

Before any operation the skill runs a bootstrap sequence that ensures the Atris CLI is installed, the local Atris token exists, and the Google Calendar integration is connected. It then uses the Atris API endpoints with the Bearer token to list events, get today’s events, create events (POST), update events (PUT), and delete events (DELETE). Responses are parsed and formatted for human-friendly display.

When to use it

• When a user asks “What’s on my calendar today?” or for their schedule this week.
• When creating or scheduling a meeting with specific attendees, time, and location.
• When confirming the next meeting or checking for meetings this afternoon.
• When updating or canceling an existing event after user confirmation.
• When checking integration status or troubleshooting authentication issues.

Best practices

• Always run the bootstrap sequence once before making API calls to validate token and connection.
• Use POST to create events; use PUT only for updating existing events and DELETE for removals.
• Format output sorted by start time, use 12-hour AM/PM display, and show location and up to 3 attendees.
• Confirm destructive actions (deletes) with the user before calling DELETE.
• Handle common errors: prompt re-authentication on token expiry and retry after rate-limit delays.

Example use cases

• Fetch today’s events and display a concise schedule with times, titles, locations, and attendees.
• Schedule a 1-hour meeting with attendees, description, and Zoom link using a POST request.
• Find the next upcoming meeting after the current local time and report time and title.
• Cancel a specified meeting at 3:00 PM after user confirmation using the DELETE endpoint.
• Show the week’s agenda by calling the events endpoint with days=7 and grouping by day.