---
name: samio-lesson-planning
description: Plan a term or a week for a real class with Samio for Schools — topic plans, week lessons, teaching materials and challenges created in the teacher's own Samio account. Use when a connected teacher asks to plan lessons, build a term overview, generate a mind map / presentation / study cards, or prepare a quiz for one of their classes.
---

# Lesson planning in the teacher's Samio account

Requires the connected account (see the `samio-setup` skill). Everything created here appears in the teacher's dashboard at schools.samiolearning.com; nothing is sent to students automatically.

## Steps
1. `list_my_classes` → pick the class the teacher means (confirm if ambiguous). Use its `classId`, `gradeLevel` and `subjects`.
2. Ground the plan: `search_curriculum_standards` for the class's country, subject and grade, optionally with the teacher's topic as `query`. Note the `unitId`s you want the plan to hit.
3. Create the plan: `create_topic_plan` with `classId`, `subject`, `mode: "plan"` (outline only, fast) or `mode: "auto"` (plan → lessons → materials → challenges, several minutes), optional `weeks` and a one-paragraph `classProfile` (level, needs, interests the teacher mentioned).
4. Generation is asynchronous. Tell the teacher it is running, then poll `get_topic_plan` with the `planId` every minute or when they ask; report `progress.phase` and `percent`. Do not poll more often than once a minute.
5. For a specific week: `get_topic_plan_week` with `planId` and `weekNumber` → lesson, materials and challenges of that week. Summarise; link the dashboard when `dashboardUrl` is present.
6. Extra material for a week or topic: `generate_teaching_material` with `materialType` from `list_material_types` (`mindmap`, `presentation`, `didactic_material`, `study_cards`), `topic`, `classId` (or `subject` + `gradeLevel`), `unitId` when you have one. Poll `get_teaching_material`.
7. A quick quiz: `generate_challenge` with `classId`, `subject`, `count` (≤ 10), optional `exerciseTypes`, `unitId`, `topic`. Leave `publish` false unless the teacher explicitly asks to publish to the class. Exercises are generated in the background: poll `get_challenge` with the `challengeId` after about a minute and report the preview questions.

## Rules
- Confirm the class and the subject before creating anything; creations count against the school's plan.
- Never claim to see students: the tools expose class names and student counts only. Curriculum progress (`get_class_curriculum_progress`) is a class-level rollup.
- Quote the curriculum units the plan targets so the teacher can check alignment.
- If a tool answers `AGENT_SCHOOL_QUOTA_EXCEEDED` or `PLAN_LIMIT_REACHED`, explain the limit and stop; do not retry.