How do I install the Wilma skill?

Run npx skillmds add modbender/wilma in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Wilma safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Wilma?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Wilma free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Wilma by modbender — Agent Skill

Name: Wilma
Rating: 4.666666666666667 (3 reviews)
Author: modbender

Wilma

Access Finland's Wilma school system from AI agents. Fetch schedules, homework, exams, grades, messages, and news via the wilma CLI. Start with `wilma summary --json` for a full daily briefing, or drill into specific data with individual commands.

modbender 9bf3bef 2 files · 4.0 KB Updated Sep 9, 2026 12 repo stars

File contents

Wilma Skill

Overview

Wilma is the Finnish school information system used by schools and municipalities to share messages, news, exams, schedules, homework, and other student-related updates with parents/guardians.

Use the wilma / wilmai CLI in non-interactive mode to retrieve Wilma data for AI agents. Prefer --json outputs and avoid interactive prompts.

Quick start

Install

npm i -g @wilm-ai/wilma-cli

Ensure the user has run the interactive CLI once to create ~/.config/wilmai/config.json.
Use non-interactive commands with --json.

Core tasks

Daily briefing (start here)

wilma summary --student <id|name> --json
wilma summary --all-students --json

Returns today's and tomorrow's schedule, upcoming exams, recent homework, recent news, and recent messages in one call. This is the best starting point for any parent-facing summary.

Schedule

wilma schedule list --when today --student <id|name> --json
wilma schedule list --when tomorrow --student <id|name> --json
wilma schedule list --when week --student <id|name> --json

Homework

wilma homework list --student <id|name> --json

Upcoming exams

wilma exams list --student <id|name> --json

Exam grades

wilma grades list --student <id|name> --json

List students

wilma kids list --json

News and messages

wilma news list --student <id|name> --json
wilma news read <id> --student <id|name> --json
wilma messages list --student <id|name> --folder inbox --json
wilma messages read <id> --student <id|name> --json

Fetch data for all students

All list commands support --all-students:

wilma summary --all-students --json
wilma homework list --all-students --json
wilma exams list --all-students --json

You can also pass a name fragment for --student (fuzzy match).

Notes

If no --student is provided, the CLI uses the last selected student from ~/.config/wilmai/config.json (or $XDG_CONFIG_HOME/wilmai/config.json).
If multiple students exist and no default is set, the CLI will print a helpful error with the list of students.
When the account has multiple students, --student is required for read commands.
If auth expires or the CLI says no saved profile, re-run wilma interactively or use wilma config clear to reset.
Run wilma update to update the CLI to the latest version.

Actionability guidance (for parents)

Wilma contains a mix of urgent items and general info. When summarizing for parents, prioritize actionable items:

Include items that:

Require action or preparation (forms, replies, permissions, materials to bring).
Announce a deadline or time-specific requirement.
Describe a schedule deviation or noteworthy event (trips, themed days, school closures, exams).
Mention homework, exams, or upcoming deadlines.

De-prioritize items that:

Are purely informational with no action, deadline, or schedule impact.
Are generic announcements unrelated to the target period.

When in doubt, include and let the parent decide. Prefer a short, structured summary with dates and IDs.

Scripts

Use scripts/wilma-cli.sh for a stable wrapper around the CLI.

Links

GitHub: https://github.com/aikarjal/wilmai
Website: https://wilm.ai

---name: wilmadescription: Access Finland's Wilma school system from AI agents. Fetch schedules, homework, exams, grades, messages, and news via the wilma CLI. Start with `wilma summary --json` for a full daily briefing, or drill into specific data with individual commands.--- # Wilma Skill ## Overview Wilma is the Finnish school information system used by schools and municipalities to share messages, news, exams, schedules, homework, and other student-related updates with parents/guardians. Use the `wilma` / `wilmai` CLI in non-interactive mode to retrieve Wilma data for AI agents. Prefer `--json` outputs and avoid interactive prompts. ## Quick start ### Install ```bash npm i -g @wilm-ai/wilma-cli ``` 1. Ensure the user has run the interactive CLI once to create `~/.config/wilmai/config.json`. 2. Use non-interactive commands with `--json`. ## Core tasks ### Daily briefing (start here) ```bash wilma summary --student <id|name> --json wilma summary --all-students --json ``` Returns today's and tomorrow's schedule, upcoming exams, recent homework, recent news, and recent messages in one call. This is the best starting point for any parent-facing summary. ### Schedule ```bash wilma schedule list --when today --student <id|name> --json wilma schedule list --when tomorrow --student <id|name> --json wilma schedule list --when week --student <id|name> --json ``` ### Homework ```bash wilma homework list --student <id|name> --json ``` ### Upcoming exams ```bash wilma exams list --student <id|name> --json ``` ### Exam grades ```bash wilma grades list --student <id|name> --json ``` ### List students ```bash wilma kids list --json ``` ### News and messages ```bash wilma news list --student <id|name> --json wilma news read <id> --student <id|name> --json wilma messages list --student <id|name> --folder inbox --json wilma messages read <id> --student <id|name> --json ``` ### Fetch data for all students All list commands support `--all-students`: ```bash wilma summary --all-students --json wilma homework list --all-students --json wilma exams list --all-students --json ``` You can also pass a name fragment for `--student` (fuzzy match). ## Notes - If no `--student` is provided, the CLI uses the last selected student from `~/.config/wilmai/config.json` (or `$XDG_CONFIG_HOME/wilmai/config.json`). - If multiple students exist and no default is set, the CLI will print a helpful error with the list of students. - When the account has multiple students, `--student` is **required** for read commands. - If auth expires or the CLI says no saved profile, re-run `wilma` interactively or use `wilma config clear` to reset. - Run `wilma update` to update the CLI to the latest version. ## Actionability guidance (for parents) Wilma contains a mix of urgent items and general info. When summarizing for parents, prioritize **actionable** items: **Include** items that: - Require action or preparation (forms, replies, permissions, materials to bring). - Announce a deadline or time-specific requirement. - Describe a schedule deviation or noteworthy event (trips, themed days, school closures, exams). - Mention homework, exams, or upcoming deadlines. **De-prioritize** items that: - Are purely informational with no action, deadline, or schedule impact. - Are generic announcements unrelated to the target period. When in doubt, **include** and let the parent decide. Prefer a short, structured summary with dates and IDs. ## Scripts Use `scripts/wilma-cli.sh` for a stable wrapper around the CLI. ## Links - **GitHub:** https://github.com/aikarjal/wilmai - **Website:** https://wilm.ai

Frequently asked questions