calendar-stats

Compute meeting metrics from Apple Calendar data for a specified date range.

5|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/aashari/ai-agent-skills --skill calendar-stats
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: calendar-stats
Source: https://github.com/aashari/ai-agent-skills/tree/main/skills/apple-calendar/calendar-stats
Command: npx skills add https://github.com/aashari/ai-agent-skills --skill calendar-stats

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps you understand your calendar workload by computing meeting volume, total hours in meetings, busiest days, and top calendars from Apple Calendar data.

Core Features & Use Cases

  • Compute and summarize meeting activity over a time range, including daily hours and counts.
  • Identify patterns such as busiest days and calendars with the most events to inform scheduling decisions.
  • Use Case: If you want a quick audit of your monthly calendar load to plan focus time, run the stats for the last 30 days.

Quick Start

Provide a date range argument (e.g., last 30 days) to generate calendar statistics.

Frequently Asked Questions about calendar-stats

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I calculate meeting hours from Apple Calendar data over a custom time range?

Calculate meeting hours from Apple Calendar data by providing a custom time range like last 30 days to generate totals, daily breakdowns, and busiest days using sqlite3 access to the local Calendar database.

Do I need sqlite3 installed to compute calendar statistics?

Yes, you need sqlite3 access because the skill directly queries the Apple Calendar SQLitedb to extract and aggregate meeting volume, total hours, and top calendars for your specified date range.

What calendar metrics are included in a time range workload analysis?

A time range workload analysis includes total meeting counts, total hours spent, event breakdowns by day of week, busiest days, and top calendars contributing to your overall schedule load.

How can I identify my busiest days and top calendars for meeting load?

Identify your busiest days and top calendars by running this analysis on a specified date range, which processes Apple Calendar data to highlight peak scheduling periods and most active event sources.

Can I audit my monthly meeting volume to plan focus time?

Yes, you can audit monthly meeting volume by passing a date range like last 30 days to compute total meeting hours and daily counts, helping you identify gaps to schedule focus time.