Daily triage of Wilma school notifications for Finnish parents. Fetches exams, messages, news, schedules, homework, and lesson notes (merkinnät) — filters for actionable items, syncs exams to Google Calendar, and reports via chat. Requires the `wilma` skill and `gog` CLI (or `gog` skill from ClawHub) for calendar access. Use when this capability is needed.
Daily triage of Wilma school notifications for Finnish parents. Fetches exams, messages, news, schedules, homework, and lesson notes (merkinnät) — filters for actionable items, syncs exams to Google Calendar, and reports via chat. Requires the `wilma` skill and `gog` CLI (or `gog` skill from ClawHub) for calendar access. Use when this capability is needed.
metadata
{"author":"aikarjal"}
Wilma Triage
Automated daily triage of Wilma school data for parents. Filters noise, surfaces actionable items, and syncs exams/events to Google Calendar.
Dependencies
wilma skill — install from ClawHub (clawhub install wilma) for Wilma CLI commands and setup
gog skill — install from ClawHub (clawhub install gog) for Google Calendar sync
First Run Setup
On first use, collect and store configuration:
Discover kids: Run wilma kids list --json to get student names, numbers, and schools
Calendar ID: Run gog calendar calendars to list available calendars. Ask the user which calendar to use for school events. Store the calendar ID in TOOLS.md under a ## Wilma Triage section along with naming conventions for events.
Preferences: Ask about any kid-specific rules (e.g., subject overrides like ET instead of religion). Store in MEMORY.md as part of the Wilma triage context.
Over time, the user will give feedback on what to report and what to skip — store these preferences in MEMORY.md. The triage gets smarter with use.
Workflow
Fetch data — check TOOLS.md for student details, then start with summary:
# Best starting point — returns schedule, exams, homework, news, messages
wilma summary --all-students --json
# Drill into specifics as needed
wilma exams list --all-students --json
wilma schedule list --when today --all-students --json
wilma schedule list --when tomorrow --all-students --json
wilma homework list --all-students --limit 10 --json
wilma grades list --all-students --limit 5 --json
wilma messages list --all-students --limit 10 --json
wilma news list --all-students --limit 10 --json
# Lesson notes (merkinnät) — fetch yesterday's notes during a morning run,# since teachers fill them during/after class. For a same-day check later# in the afternoon, omit --date.
wilma attendance list --all-students --date <yesterday-YYYY-MM-DD> --json
# Read full content when subject line looks actionable
wilma messages read <id> --student <name> --json
wilma news read <id> --student <name> --json
Filter — apply triage rules below plus any kid-specific rules from MEMORY.md
Calendar sync — add missing exams and actionable events using gog CLI commands from TOOLS.md
ALWAYS check for existing events before adding to avoid duplicates
Use naming conventions stored in TOOLS.md
Remove cancelled events from calendar
Report — if actionable items found, send details. If nothing actionable, stay silent or send a brief confirmation. Check MEMORY.md for the user's notification preference.
Calendar Sync
Refer to TOOLS.md for the calendar ID, naming conventions, and exact gog CLI commands.
NO DUPLICATES rule:
Before adding any event, check calendar for that date range
If a matching event exists (same date + child + subject keywords), skip it
Only add if not already there
Understanding Wilma Messages
Wilma messages come from different sources and have very different signal-to-noise ratios. Knowing the difference is critical for good triage:
Viikkoviesti / weekly letter (from class teacher) — HIGH VALUE. These are the class teacher's weekly updates. They look like casual newsletters but frequently contain buried actionable items: upcoming exams, materials to bring, schedule changes, field trips, deadlines. Always read the full content. Never skip based on subject line.
Teacher messages (from subject teachers) — Usually about specific exams, homework, or class events. High signal.
School office / rehtori messages — Administrative: schedule changes, events, policy updates. Medium signal — skim for actions.
Kuukausitiedote / monthly newsletter (from school office) — Read these. They typically contain important dates: holidays, school year start/end, event schedules, enrollment deadlines. Don't skip based on the generic subject line.
City-wide notices (from Helsinki/municipality) — Health campaigns, transport info, surveys. Usually noise for daily triage. Skim subject, skip unless clearly actionable.
Parent union / vanhempainyhdistys — Low signal by default (fundraising, volunteer calls). However, check MEMORY.md — if the parent is actively involved in the union, these become high priority.
Rule of thumb: If a message is from a teacher (class teacher or subject teacher), always read it. If it's from the school office or city, skim the subject and skip unless it's clearly actionable.
Understanding Lesson Notes (merkinnät)
Lesson notes are short per-lesson remarks teachers leave in Wilma. They fall into a few categories — signal varies a lot:
Behavioral concerns (e.g. "Sinulta puuttui opiskeluvälineitä" = "you were missing study materials", "Häiritsi tuntia" = "disrupted class") — Report. Parents typically want to know and may want to follow up.
Unexplained absences ("Selvittämätön poissaolo") — Report immediately. Could indicate truancy or that the parent forgot to file an excuse in Wilma.
Explained absences ("Terveydellinen syy" = medical, "Muu selvitetty poissaolo" = other-explained) — Report briefly as confirmation that the absence is logged. Skip if MEMORY.md says the parent doesn't want absence confirmations.
Positive feedback ("Hyvä!", "Osasit toimia ryhmän vastuullisena jäsenenä") — Skip by default. Mention occasionally if MEMORY.md indicates the parent wants positive notes too.
Note with parenthetical detail (e.g. "Muu selvitetty poissaolo; Lähti 13.00" = "left at 13:00") — the extra clause after the semicolon is often the most useful part. Surface it.
The typeLabel field in the JSON is the full Finnish reason; subject is the course code (e.g. MA_8LV). Group consecutive same-subject same-type notes when reporting (one absence often spans multiple periods).
Triage Rules
Always Report (Actionable)
Forms, permission slips, replies needed
Deadlines (sign-ups, payments, materials to bring)
Weekly letters from class teachers often contain actionable items buried in the text: exams, materials to bring, schedule changes, field trips. Always read the full content of viikkoviesti messages — do not skip based on subject line alone.
Day-Before Logistics (critical!)
Viikkoviestit and teacher messages often contain operational details for upcoming days that don't map to calendar events but are essential for parents the day/evening before:
Modified start/end times (e.g., "9:30 kouluun" instead of the normal 8:30)
What to bring/pack (water bottle, outdoor clothes, snacks, specific gear)
Which lessons are cancelled due to trips or events (e.g., no ET, no electives)
Pickup/return time changes (e.g., "paluu koululle noin klo 15")
Order of the day (e.g., "exam first, then trip immediately after")
These details are just as important as exams and schedule changes. A parent who knows there's a Superpark trip but doesn't know school starts at 9:30 instead of 8:30 has incomplete information.
Workflow:
When reading viikkoviestit, extract ALL day-specific logistics for the next 2-3 school days
If today's triage finds logistics for tomorrow or the day after, always report them even if the underlying event (trip, exam) is already on the calendar
Include: modified times, what to bring, cancelled lessons, transport details, return times
Don't assume calendar sync = job done — the calendar has the event but not the logistics
Example of what gets missed without this: Calendar shows "Superpark trip" and "History exam" on Friday. But the viikkoviesti says school starts at 9:30 (not 8:30), history exam is first, bring water bottle + snacks, no ET or electives, return around 15:00. All of that is critical for the parent to know the evening before.
Skip Silently
Concerts, cultural performances (FYI only)
Generic "welcome back" or seasonal greetings
City-wide informational notices (health campaigns, transport info, surveys)
Parent union messages (unless user is actively involved — check MEMORY.md)
Check MEMORY.md for additional skip/report rules the user has provided over time (e.g., subject overrides, school-specific filtering).
Suggested Cron Setup
Run daily at 07:00 local time as an isolated agentTurn job:
Schedule: 07:00 daily
Timeout: 180s
Task: "Read the wilma-triage skill, then run the full triage workflow. Report actionable findings."
Stagger with other morning jobs (e.g., email check at 07:05) to avoid API rate limits.
Output Format Example
📚 Wilma Update
Child A (8th grade)
• Math exam tomorrow — yhtälöt, kpl 1-8
• Friday short day (9:20-12:35) — kulttuuripäivä, bring laptop + outdoor clothes
• Lesson note (yesterday, MA_8LV): "Sinulta puuttui opiskeluvälineitä" — kirja jäi kotiin
Child B (6th grade)
• No actionable items
📅 Calendar: Added Child A math exam (Feb 10), removed cancelled disco (Feb 11)
Keep it brief. One line per item. Silence is better than noise.
