Agent skill · bighardperson
caldav-calendar
Sync and query CalDAV calendars (iCloud, Google, Fastmail, Nextcloud, etc.) using vdirsyncer + khal. Works on Linux.
What it needs
About 2k tokens when loaded.
What this skill does
CalDAV Calendar (vdirsyncer + khal) vdirsyncer syncs CalDAV calendars to local .ics files. khal reads and writes them. Sync First Always sync before querying or after making changes: View Events Search Create Events After creating, sync to push changes: Edit Events (interactive) khal edit is interactive — requires a TTY. Use tmux if automating: Menu options: s → edit summary d → edit description t → edit datetime range l → edit location D → delete event n → skip (save changes, next match) q → quit After editing, sync: Delete Events Use khal edit, then press D to delete. Output Formats For scripting: Placeholders: {title}, {description}, {start}, {end}, {start-date}, {start-time}, {end-date}, {end-time}, {location}, {calendar}, {uid} Caching khal caches events in ~/.local/share/khal/khal.db. If data looks stale after syncing: Initial Setup 1. Configure vdirsyncer (~/.config/vdirsyncer/config) Example for iCloud: Provider URLs: iCloud: https://caldav.icloud.com/ Google: Use googlecalendar storage type Fastmail: https://caldav.fastmail.com/dav/calendars/user/EMAIL/ Nextcloud: https://YOUR.CLOUD/remote.php/dav/calendars/USERNAME/ 2. Configure khal (~/.config/khal/config) 3. Discover and sync
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills bighardperson/CalDAV 日历