openmaic-classroom — Claude Code skill: interactive lessons
A skill that generates interactive lessons: slides, quizzes, simulations and project work come out of a multi-agent pipeline. Useful when you need a course from a topic or document.
npx skills add reason-machines/trending-skills --skill openmaic-classroom -a claude-codeWhat openmaic-classroom does
The skill sets up OpenMAIC, a Next.js 16, React 19 and TypeScript platform where a lesson is built in two stages. First the AI reads a topic or document and produces a structured outline, then each item expands into a scene of one type: slides with narration and a laser pointer, quiz with AI grading, interactive with an HTML simulation, or pbl where learners pick a role and work with agents. LangGraph 1.1 handles orchestration.
You need Node.js 20 or newer, pnpm 10, and at least one LLM provider key in .env.local — OpenAI, Anthropic or Google. Providers can also go into server-providers.yml, which accepts any OpenAI-compatible endpoint. Separate MinerU variables cover PDFs with tables and formulas. Start with pnpm dev or docker compose up --build; both serve the app on port 3000.
Generation is asynchronous: a job goes to POST /api/generate, then you poll GET /api/generate/status?jobId=<jobId> until it returns a classroom link. Finished lessons export to PPTX or HTML. Scenes are typed React components, so a new type means editing types/scene.ts and adding a component. No key means the pipeline never starts — check that first.
What it helps with
- turn an uploaded document into an interactive lesson
- generate narrated slides for a given topic
- add a quiz with automatic grading
- build an HTML simulation to explain a process
- assign roles and run a project-based session with agents
Example prompts for the agent
- set up OpenMAIC and run it locally
- generate a lesson on quantum entanglement
- add a quiz scene to the finished classroom
How to install openmaic-classroom
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill openmaic-classroom -a claude-code2Manually: put the files in place
~/.claude/skills/openmaic-classroom/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/openmaic-classroom/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill openmaic-classroom -a codex2Manually: put the files in place
.agents/skills/openmaic-classroom/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill openmaic-classroom -a cursor2Manually: put the files in place
.cursor/skills/openmaic-classroom/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/trending-skills openmaic-classroom2Manually: put the files in place
.github/skills/openmaic-classroom/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill openmaic-classroom -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/trending-skills --path skills/openmaic-classroomManually: put the files in place
.devin/skills/openmaic-classroom/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/trending-skills --skill openmaic-classroom -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about openmaic-classroom
How do I install openmaic-classroom in Claude?
Run npx skills add reason-machines/trending-skills --skill openmaic-classroom -a claude-code. The skill file lands at ~/.claude/skills/openmaic-classroom/SKILL.md.
What does openmaic-classroom do?
It sets up the OpenMAIC platform and walks through lesson generation: an outline first, then scenes of four types — slides, quizzes, simulations and project-based activities.
What does OpenMAIC need to run?
Node.js 20 or newer, pnpm 10, and at least one LLM provider key in .env.local. Without a key generation will not start.