ics-calendar-reader

Installation
SKILL.md

ICS Calendar Reader

Parse .ics files with scripts/read_ics.py instead of hand-parsing text.

Prerequisite

  • Set ICS_URLS to one or more calendar URLs (comma-separated).
    • Example: export ICS_URLS="https://example.com/a.ics,https://example.com/b.ics"
  • Secrets/defaults file: ~/.config/stu-skills/ics-calendar-reader/.env
    • The script reads this path from ics-calendar-reader/.env-path automatically.
  • If ICS_URLS is missing and no ics_path is provided, the script exits with an instruction for the agent to ask the user for it.
  • Do not paste private calendar URLs in prompts or command lines; run the script and let it read from env.
  • The parser refuses --url inputs by design and instructs using ICS_URLS from .env.
  • ICS_URLS entries using webcal:// or webcals:// are normalized to https:// automatically.

.env Sample

Path: ~/.config/stu-skills/ics-calendar-reader/.env

Related skills
Installs
3
First Seen
Feb 12, 2026