caldav-calendar-ops

---

name: caldav-calendar-ops description: Use this skill for generic calendar operations via CLI: discover configured calendars, sync, list/search events, and create/update/delete events against configured calendar targets. compatibility: Requires vdirsyncer and khal. curl may be used only for low-level troubleshooting. metadata: author: voicemail version: "1.2" scope: caldav-calendar-cli allowed-tools: Bash Read Write Grep Find

CalDAV Calendar Operations Skill (CLI-first)

Use this skill for reusable, configuration-driven calendar workflows.

Workflow

If anything is missing or not working, check references/config.md first and apply its remediation flow before continuing.

1. Load configured calendar targets

• Read target calendars/accounts from config or environment.

2. Preflight

• Verify required CLI tools are available (vdirsyncer, khal).

3. Sync before reads

• Run calendar sync, then list/search events.

4. CRUD verification

• Create event
• Read/list to confirm
• Update event
• Read/list to confirm update
• Delete event
• Read/list to confirm removal

5. Output handling

• Always include timezone explicitly.
• Return concrete time options when scheduling.

Operating rules

• No provider-specific account details in this file.
• No hardcoded calendar URLs, users, or domains.
• Keep this skill focused on workflow; place setup specifics in references.

Common gotchas

• 401/403: invalid credentials/auth method
• Empty results: wrong collection target
• Missing events: sync not run before listing
• Time drift: timezone mismatch
• Recurrence edits: single instance vs full series

References

• Configuration contract: references/config.md
• Concrete setups: references/examples.md
• Command snippets: references/commands.md

Output requirements

When completing a task, always include:

1. Commands run
2. Before/after validation output
3. Manual follow-up steps (if any)