How to use the k12-core-literacy-planning agent skill

What the skill makes the agent do

The skill tells the agent to build a persisted OpenMAIC stage: pages, roles, learner activities, assessment evidence and narration. It does not produce a Word lesson plan, a lesson.json file, HTML, or instructions for running local render scripts.

Every lesson follows the chain authentic context → performance task → learning activity → observable evidence → transfer. The agent first loads core-literacy.md and one matching subject guide, then proposes a page-by-page plan for the teacher to approve before it creates anything.

• Loads reference files for the subject and school stage before planning
• Chooses one or two primary literacy dimensions for the lesson
• Proposes 6–10 pages by default for a 45-minute lesson, each with a learner action and evidence
• Creates the stage, roles and pages in OpenMAIC only after approval, then checks narration audio

Install the skill

You can install the skill in two ways. Download the ZIP from this page and unzip it into ~/.claude/skills/ for personal use, or into a project's .claude/skills/ folder to share it with a project. Alternatively, in the Claude apps, upload it under Settings → Capabilities → Skills.

After installing, the folder should contain SKILL.md and the references folder with core-literacy.md and the subject guides for humanities, languages, mathematics and science.

• Personal: unzip into ~/.claude/skills/
• Project: unzip into the project's .claude/skills/
• Claude apps: Settings → Capabilities → Skills, then upload

Trigger the skill with a natural request

The skill is meant to activate when a teacher asks for a grade-and-subject lesson in OpenMAIC. Its description lists trigger terms including 中小学课程, 核心素养, 素养导向, 2022 课标, 真实情境, 任务群 and 表现性评价. You do not need to name the skill; state the grade, subject and the kind of lesson you want.

If the grade or topic is unknown, the agent may ask at most two load-bearing questions. It defaults the rest to 45 minutes and general curriculum expectations.

• Give the grade, subject and class length in the first message
• Name a textbook edition or attach material if you want alignment to it; otherwise the lesson is not tied to a specific edition

Example requests

The examples below show the kind of request the skill is written for. They are phrasing patterns, not outputs.

• 初二物理，做一节围绕真实情境的浮力课，45 分钟，用 OpenMAIC 创建课堂
• 小学三年级语文，设计一节以校园开放日导览词为任务的课，任务群导向
• 高中历史，用两份史料设计一节课，考查史料实证和历史解释，表现性评价

What the skill needs to run

The skill works only inside an OpenMAIC environment. It relies on that platform's stage tools: create_stage, set_roster, generate_scene, list_scenes, generate_tts, ask_user and read. It also needs the reference files in its own folder. It runs no scripts and does not use the network.

• OpenMAIC platform with its stage tools
• Reference files in the skill folder (core-literacy.md and subject guides)
• No scripts are run; no network use

Safety notes on scripts and network

According to the skill's own description, it runs no scripts and uses no network. Its work happens through OpenMAIC's stage tools. Because it does not run scripts, it does not produce local render commands, which the skill explicitly says not to give.

• Scripts: none run
• Network: none used
• Output lives in the OpenMAIC stage, not in files on your computer

Tips for better results

State the learning goal in visible terms, such as annotate, compare, justify or design. The skill itself rejects vague goals like 'understand' or 'master'. Ask for a real context that the whole lesson will return to, and review the page plan before approving it, since the agent waits for your approval before building.

• Give a real-world situation you want the lesson to return to
• Check the page plan carefully at the approval step
• Ask the agent to read back the finished pages if you want to verify them