soia-edu-compose-lesson-plan

Expand a confirmed syllabus into per-class-hour executable lesson plans and lecture note structures, covering introduction, explanation, practice, summary, interaction, homework, and extension. Keep teaching objectives, activities, and assessment aligned, and do not fabricate learner privacy or classroom facts.

Client-readable description

What this skill can do

Client wants	Skill does	Client can see
Turn a syllabus into teachable lesson plans	Extract single-lesson objectives, content, and assessment evidence, and arrange classroom segments	Per-class-hour flow, teacher actions, learner tasks, and time allocation
Prepare a lecture note framework	Organize core concepts, examples, exercises, and summary into a lecture note hierarchy	Lecture note outline and content prompts ready for direct expansion
Add interaction and after-class learning	Design questions, collaboration, homework, and extension aligned with objectives	Interaction rules, homework requirements, evaluation criteria, and extension resource directions

How clients use it

Provide a confirmed syllabus, including at least the lesson's teaching objectives, audience starting point, class-hour length, and assessment method.
Optionally describe class size, teaching mode, available equipment, material constraints, and accessibility needs; use only aggregate descriptions.
Specify whether to generate one class hour or a full course, and state whether a detailed plan, brief plan, or lecture note structure is needed.
Review the time budget, interaction feasibility, and homework load, then propose adjustments.

Dependencies and installation

This skill is a pure methodology skill with no hard dependencies, scripts, or external services; lesson plans and lecture note structures can be completed without configuration.

claude plugin marketplace add soia-team/soia-open-skills

claude plugin install soia-edu-course@soia

When only this skill is needed, the npx route can be used. Note that the skill will land in the shared source of truth ~/.agents/skills; if a plugin is also installed, the same skill will appear in two indexes and drift separately, so choose one of the two:

npx skills add soia-team/soia-open-edu-course-skills -g -a '*' -s soia-edu-compose-lesson-plan -y

If personalized teaching preferences need to be saved, they can only be placed in the user's own schema v2 configuration:

~/.config/soia-skills/soia-edu-compose-lesson-plan/config.yml

schema_version: 2
defaults:
  lesson_minutes: 45
  plan_detail: detailed
  interaction_modes: [think_pair_share]

Configuration is entirely optional. If courseware slides need to be produced, the cross-repository skill can optionally be used soia-dev-open-design-ops; when it is missing, still deliver the complete lesson plan and lecture note structure, omitting only the slide production step.

WorkBuddy 's loading unit is a role-based expert rather than a plugin,npx skills add -a '*' cannot cover it, and it must be installed separately, see docs/install/workbuddy.md。

Private information and intermediate data

Only receive aggregate information needed to complete instructional design; do not request real names, schools, contact information, grade details, health conditions, or family situations.
Personalization preferences can only go into the above user-private configuration; use anonymous codes, ranges, or group characteristics, and do not copy configuration content into public examples or logs.
By default, generate drafts in the conversation and do not create intermediate files. When the client requests saving, use the client-specified location and explain which resource categories were created.
When citing client materials, extract only the necessary content; receipts must not expose local absolute paths, account information, or identifiable learner data.

Logs and completion receipts

On completion, report: the class-hour range handled, per-class-hour minute accounting, the interaction and homework types adopted, objective alignment checks, explicit assumptions, and unresolved issues. Do not print private configuration content or individual learner information.

Input contract

Prioritize receiving a structured outline; at minimum it needs:

course_title: <课程名>
lesson:
  number: <课时序号>
  title: <课时标题>
  minutes: <正整数>
  objectives: [<可测量目标编号与文本>]
  key_points: []
  formative_assessment: <证据与判定方式>
audience:
  starting_level: <聚合描述>
delivery:
  mode: <线下|线上|混合>
  available_materials: []

If the outline lacks measurable objectives or total duration, first request that they be completed; if you cannot wait, state assumptions explicitly and mark the result as a draft pending confirmation. Do not infer specific learning difficulties, grades, or family background from vague audience descriptions.

Workflow

Validate the outline. Check whether each lesson objective is measurable, whether lesson points match the objectives, and whether assessments can provide evidence of attainment; if the problem is serious, give feedback first rather than blindly expanding.
Determine delivery granularity. Clarify the lesson scope, detailed or brief plan, whether a handout structure is needed, and the teaching mode and material constraints.
Allocate time. First reserve time for the summary and formative checks, then allocate the remaining time to introduction, explanation, and practice; the sum of minutes for all segments must equal the lesson length.
Design the introduction. Use questions, scenarios, or quick tasks to activate prior knowledge and clarify the lesson objectives; do not use lively activities unrelated to the objectives.
Organize the explanation. Break the content into short explanation units, each with examples, comprehension-check questions, or visual cues.
Arrange practice and interaction. Move from demonstration to guided practice to independent transfer; write clearly the grouping method, instructions, outputs, observation points, feedback method, and backup options.
Design the summary and assessment. Have learners produce checkable evidence, tie back to the objectives, and state the criteria for judging attainment; do not use “Do you understand?” as the only check.
Assign homework and extension. Distinguish required, optional, and extension tasks, and explain the estimated time, deliverables, evaluation criteria, and relationship to the next lesson.
Build the handout structure. Organize headings, key concepts, examples, practice areas, common pitfalls, summary, and self-check according to the learning path; do not mix teacher operational instructions into the learner handout.
Stress check. Recalculate the total minutes and check material availability, interaction scale, online/offline suitability, objective coverage, and cognitive load.
Delivery and receipt. Provide the lesson plan, handout structure, assumptions, alternatives, and verification results.

Output contract

A. Lesson plan

Lesson information: course, lesson number, topic, duration, teaching mode, audience starting point.
Lesson objectives and evidence: objective number, attainment performance, formative assessment.
Preparation checklist: teacher materials, learner materials, space or equipment, accessibility alternatives.
Classroom flow table: time period, segment, teacher actions, learner tasks, interaction mode, materials, checkpoints, and contingency plans.
Summary and exit evidence: questions or outputs that tie back to the objectives, judgment method, immediate feedback.
Homework and extension: required/optional, estimated time, deliverables, criteria, connection to the next lesson.
Post-class reflection prompts: what evidence to observe, what content needs reteaching; do not record identifiable learner information.

The classroom flow must explicitly include introduction, explanation, practice, and summary. If a segment is not applicable, explain why and redistribute the time; do not silently omit it.

B. Handout structure

Topic and learning objectives.
Quick check of prior knowledge.
Core concepts and terminology.
Segmented explanations, examples, and placeholders for diagrams.
Classroom exercises and recording area.
Common mistakes and corrective tips.
Lesson summary and self-check questions.
Assignment requirements and extension directions.

C. Alignment and receipt

Attach the "objectives—classroom activities—learning evidence" alignment table, minute totals, explicit assumptions, uncovered items, and next steps. If the client chooses to produce courseware, output only the slide content outline that can be handed to soia-dev-open-design-ops ; its installation and operation are not prerequisites for this skill to complete the lesson plan.

Interaction design rules

For each interaction, state the purpose, instructions, time, organization method, expected output, and feedback method.
Provide an executable version according to class size and teaching mode; when information is insufficient, provide a low-tech default option and mark it as an assumption.
Provide equivalent ways to participate for learners who are unwilling to speak publicly or cannot use the specified equipment.
Interactions must produce observational evidence related to the teaching objectives, and must not pursue atmosphere alone.

Quality thresholds

The sum of the minutes for each segment in each class session must strictly equal the class session length.
Each objective must correspond to at least one classroom activity and one observable piece of learning evidence.
The introduction, explanation, practice, and summary all have clear functions, and the interaction instructions can be executed directly.
The assignment burden is commensurate with the audience and class session length, and includes estimated time and evaluation criteria.
The content boundaries between the lesson plan and the learner handout are clear, and the absence of slide tools does not affect the core deliverables.
Contains no real institution, student, or family information.

Fictional example

Input: "Based on the Lesson 2 outline of the sample course 'Campus Weather Observation,' write a 45-minute lesson plan and handout structure, for an audience of beginner learners."

"Sample course" is only a fictional placeholder; do not add real school, class, teacher, student, or family information.