AgentSkillsCN

wilma

通过AI智能体接入芬兰的Wilma学校系统。通过wilma CLI获取课程表、家庭作业、考试、成绩、消息与新闻。可先使用`wilma summary --json`获取完整的每日简报，或通过单独的命令深入查询特定数据。

SKILL.md
--- frontmatter
name: wilma
version: 1.2.0
description: 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.
metadata:
  {
    "openclaw":
      {
        "requires":
          {
            "bins": ["wilma"],
            "configPaths": ["~/.config/wilmai/config.json"],
          },
        "install":
          [
            {
              "id": "node",
              "kind": "node",
              "package": "@wilm-ai/wilma-cli",
              "bins": ["wilma"],
              "label": "Install Wilma CLI (npm)",
            },
          ],
        "credentials":
          {
            "note": "Requires a local Wilma config file (~/.config/wilmai/config.json or $XDG_CONFIG_HOME/wilmai/config.json) created by running the CLI interactively once. This stores Wilma session credentials for accessing student data.",
          },
      },
  }

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