| name | upcoming-calendar |
| description | How to answer "what's coming out?" — upcoming episodes of tracked shows and upcoming movie releases over a time window, across Sonarr and Radarr.
TRIGGER THIS SKILL WHEN: - "What episodes are coming out this week / next N days?" - "What's airing tonight / this weekend?" - "Any new movies releasing soon that I'm tracking?" - "What's on the calendar?"
SYMPTOMS that you skipped this skill: - Querying only Sonarr when the user said "shows and movies" - Returning raw timestamps instead of a readable, grouped summary
|
| metadata | {"version":1} |
Upcoming calendar
Pick the window
- "This week" →
days: 7. "Tonight"/"today" → a same-day ISO start/end.
- "This month"/"soon" for movies →
days: 30 (movie release dates are sparser).
- For an explicit range, pass ISO
start and end.
Query the right service(s)
- Episodes:
sonarr_calendar.
- Movie releases:
radarr_calendar.
- If the user says "shows and movies" (or just "what's coming out"), query both
and merge.
The calendar only includes tracked titles — it won't surface shows/movies the
user hasn't added. If they expected something that isn't there, it's probably not in
the library (see media-library-management).
Present it well
- Group by day, ordered chronologically.
- For episodes:
Show — S01E05 "Title" — <weekday date>, and flag whether it already
hasFile (already downloaded) vs still pending.
- For movies: show which release type the date is (cinema / digital / physical).
- Keep it scannable; don't dump raw JSON at the user.
Follow-ups
If the user then says "make sure you grab episode X when it's out" or "did last
night's episode download?", switch to the late-episode-troubleshooter skill.
