skills/calendar/SKILL.md
Use this skill when the user asks about calendar management - viewing events, scheduling meetings, checking availability, or managing appointments.
npx skillsauth add pietz/skills calendarInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
This skill automates Calendar.app with small, focused scripts stored in the scripts/ subfolder. Use them for listing events, searching by summary/location/description, and targeting events by UID. Scripts are written to work across different languages and calendar naming schemes by discovering actual calendar names first.
91ADA44E-B3BA-44F5-9006-3C077D94DACF)./scripts/list_calendars.sh to discover calendar names (including localized names)../scripts/list_today.sh or ./scripts/list_upcoming.sh --days 14 to see upcoming events and get UIDs../scripts/search_events.sh "term" --field summary --days 30 and copy the UID../scripts/get_by_uid.sh <uid> for full details or ./scripts/open_by_uid.sh <uid> to show it in Calendar.app../scripts/create_event.sh ... --confirm or ./scripts/delete_event.sh <uid> --confirm../scripts/list_calendars.sh
Lists all calendars (marks read-only calendars).
./scripts/list_today.sh
Lists today's events across all calendars.
./scripts/list_upcoming.sh --days 14
./scripts/list_upcoming.sh --days 7 --calendar "Work"
Lists upcoming events for the next N days (default: 14). Optional calendar filter.
./scripts/search_events.sh "meeting" --field summary --days 30
./scripts/search_events.sh "berlin" --field location --calendar "Work"
Searches events by summary/location/description in the next N days. Optional calendar filter.
./scripts/get_by_uid.sh "91ADA44E-B3BA-44F5-9006-3C077D94DACF"
Shows full event details for a UID (including attendees when available).
./scripts/open_by_uid.sh "91ADA44E-B3BA-44F5-9006-3C077D94DACF"
Opens the event in Calendar.app.
./scripts/create_event.sh --calendar "Work" --summary "Planning" --start "2025-01-01 10:00" --end "2025-01-01 11:00" --location "Room 2" --confirm
./scripts/create_event.sh --calendar "Personal" --summary "Day Off" --start "2025-01-01 00:00" --all-day --confirm
Creates an event. Use --start-epoch/--end-epoch if you already have Unix timestamps.
./scripts/delete_event.sh "91ADA44E-B3BA-44F5-9006-3C077D94DACF" --confirm
Deletes an event by UID (requires --confirm).
development
Finish a build session by shipping the work. Ensure tests exist and pass, validate the functionality, spawn a fresh-eyes subagent review when the change is large or risky, then commit and push to main. Use when the user says "ship", "ship it", "wrap this up and push", "test, commit and push", or otherwise wants the session's changes tested, reviewed, committed, and pushed.
development
Search YouTube and read video transcripts from the command line. Use this whenever the user wants to find YouTube videos or channels, answer a question using knowledge from YouTube videos, get/read/summarize a video's transcript or captions, or find where in a video something is discussed. Also consider this skill for general purpose research, since YouTube is a rich source of information.
development
Create visual documents (presentations, flyers, brochures, posters) by generating HTML/CSS and converting to PDF via headless Chromium. Use this skill when the user wants to create slides, presentations, pitch decks, flyers, brochures, or posters.
development
Find and remove incidental architectural complexity in an existing codebase — structure that accreted through many locally-reasonable edits until the whole became more complex than the problem warrants. Preserves what the software does for its callers while simplifying how it's built. NOT for bug fixes, feature work, formatting/style cleanup, or refactors whose change is already obvious.