# Send Wilma to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "wilma", "name": "Wilma", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/aikarjal/wilma", "canonicalUrl": "https://clawhub.ai/aikarjal/wilma", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/wilma", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=wilma", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "scripts/wilma-cli.sh" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "wilma", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-11T02:45:18.489Z", "expiresAt": "2026-05-18T02:45:18.489Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=wilma", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=wilma", "contentDisposition": "attachment; filename=\"wilma-1.5.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "wilma" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/wilma" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/wilma", "downloadUrl": "https://openagent3.xyz/downloads/wilma", "agentUrl": "https://openagent3.xyz/skills/wilma/agent", "manifestUrl": "https://openagent3.xyz/skills/wilma/agent.json", "briefUrl": "https://openagent3.xyz/skills/wilma/agent.md" } } ``` ## Documentation ### 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. ### 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. ### Daily briefing (start here) wilma summary --student --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 --json wilma schedule list --when tomorrow --student --json wilma schedule list --when week --student --json wilma schedule list --date 2026-03-10 --student --json wilma schedule list --weekday thu --student --json --weekday also accepts Finnish short forms: ma, ti, ke, to, pe, la, su. Use --date or --weekday, not both. ### Homework wilma homework list --student --json ### Upcoming exams wilma exams list --student --json ### Exam grades wilma grades list --student --json ### List students wilma kids list --json ### News and messages wilma news list --student --json wilma news read --student --json wilma messages list --student --folder inbox --json wilma messages read --student --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). ### MFA (Multi-Factor Authentication) If the Wilma account has MFA/TOTP enabled: Interactive setup (recommended): Run wilma interactively. When MFA is detected, choose "Save TOTP secret for automatic login" and paste your TOTP secret or otpauth:// URI. Future logins will auto-authenticate. Non-interactive (one-off): Pass the TOTP secret directly: wilma schedule list --totp-secret --student "Stella" --json wilma schedule list --totp-secret 'otpauth://totp/...' --student "Stella" --json If the TOTP secret has been saved via interactive setup, --totp-secret is not needed — the CLI auto-authenticates from the stored config. ### 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 ## Trust - Source: tencent - Verification: Indexed source record - Publisher: aikarjal - Version: 1.4.1 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-11T02:45:18.489Z - Expires at: 2026-05-18T02:45:18.489Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/wilma) - [Send to Agent page](https://openagent3.xyz/skills/wilma/agent) - [JSON manifest](https://openagent3.xyz/skills/wilma/agent.json) - [Markdown brief](https://openagent3.xyz/skills/wilma/agent.md) - [Download page](https://openagent3.xyz/downloads/wilma)