New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Workshop-Style Course Design

by THU-MAIC in THU-MAIC/OpenMAIC

Shapes a course as a hands-on workshop, with an exercise or check every couple of pages, short task-brief slides and a closing page that combines the pieces into a small project.

MITAuto-check passedEducation

Install Workshop-Style Course Design

skills CLI
$ npx skills add THU-MAIC/OpenMAIC --skill workshop-style -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install THU-MAIC/OpenMAIC workshop-style --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/THU-MAIC/OpenMAIC.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/agent-runtime/workshop-style .claude/skills/workshop-style && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
workshop-style
GitHub stars
40k
Token cost
~1.5k tokens
SKILL.md length
834 words
Files
2
Skills in repo
25
Repo updated
First seen
Licence
MIT

At a glance

Shapes a course as a hands-on workshop, with an exercise or check every couple of pages, short task-brief slides and a closing page that combines the pieces into a small project.

  • Designing a workshop or bootcamp session where learners build as they go
  • SKILL.md covers The shape, Slides are task briefs, widgetOutline and Narration is facilitation, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Turning a lecture outline into a learn-by-doing course

What it does

The learner works through the course rather than watching it. Scene one is a short slide stating what they will have made by the end and the first thing to try, and from then on every concept is followed at once by a hands-on page, roughly one interactive or quiz page for every two pages. Interactive pages are the exercises, each isolating one thing to build, vary or trace, and consecutive ones may not reuse the same widget type.

Quiz pages are quick self-checks of two or three questions placed right after a hands-on page, and slides are task briefs with two or three key points that exist only to make the next exercise possible. Each interactive page carries a populated widget outline with the concept and type-specific fields, such as key variables for simulations or language for code. The last page is an integrating project that uses several workshop pieces at once, not a summary. The skill builds on stage-design, is not for systematic explanatory courses or occupational procedure training, and ships an outline-constraints.json file.

When your agent uses it

  • Designing a workshop or bootcamp session where learners build as they go
  • Turning a lecture outline into a learn-by-doing course
  • Planning a closing project that combines the earlier exercises

Example prompts

  • “Design a hands-on workshop on building a REST API where each concept is followed by an exercise.”
  • “Turn this lecture outline on spreadsheets into a learn-by-doing course.”
  • “Plan the final project page that brings together the earlier exercises.”

Requirements

  • The OpenMAIC course runtime and its stage-design skill

What it can do on your machine

Read from SKILL.md and the folder at commit 6a84dbe. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Workshop-Style Course Design loads about 1.5k tokens when it runs. Until then it costs about 159 tokens; SKILL.md has 834 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~159
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from THU-MAIC/OpenMAIC at commit 6a84dbe, republished under its MIT licence (© THU-MAIC). 834 words, ~1,541 tokens.

Download SKILL.mdSave it as .claude/skills/workshop-style/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
workshop-style
description
Hands-on workshop — the learner works through the course instead of watching it, with an exercise or a check every couple of pages, short slides that only set up the next task, guiding narration that asks more than it tells, and a closing page where the pieces come together in one small project. Use when the ask is a workshop, a bootcamp session, 「动手」「实操」「练中学」「边做边学」, or a skill the learner is meant to leave holding; also use when the user names this style. Not for a systematic explanatory course (that is `lecture-style`) and not for occupational procedure training with tools and safety gates (that is `vocational`).
title
互动工作坊

Workshop design

You are designing a workshop. Nothing is explained for longer than it takes to set up the next thing the learner does, and every idea is followed immediately by a page where they try it. The learner leaves having built something, not having been told about it.

stage-design still governs how the stage is built — outline, roster, one page per generate_scene, audio before done. This skill governs what the stage contains and how it sounds.

The shape

  • Scene 1 is a slide, and it is short: what the learner will have made by the end, and the first thing they are about to try. No agenda, no history of the field.
  • Every concept is followed at once by a hands-on page. The rhythm is concept → do it, concept → do it: roughly one interactive or quiz page for every two pages in the course. If two explanatory pages ever sit next to each other, one of them is unnecessary.
  • interactive pages are the exercises. Each isolates one thing to build, vary or trace. Consecutive interactive pages must not reuse the same widgetType — as the learner moves from trying to predicting to applying, the modality moves with them.
  • quiz pages are quick self-checks, not exams — placed right after a hands-on page to make the learner state what they just observed. Short, two or three questions.
  • The last page is a small integrating project: one interactive page whose task needs several of the workshop's pieces at once, with the earlier exercises as its parts. Not a summary slide. This is the page the learner screenshots afterwards.

Slides are task briefs

A slide in a workshop exists to make the next exercise possible. Keep it to two or three keyPoints — the rule, the shape, the one gotcha — and put everything else in the exercise. A workshop slide that could be read on its own as a lesson is too long: cut it and let the interactive page teach.

widgetOutline

Every interactive page must carry a populated widgetOutline, always including concept — the one thing this exercise is about. An interactive page with an empty widget outline degrades into a generic page, which in this style takes the course's whole point with it.

  • simulation: concept, keyVariables (the actual things the learner moves)
  • code: concept, language
  • diagram: concept, diagramType, nodes
  • game: concept, gameType, challenge, playerControls
  • visualization3d: concept, visualizationType, objects, interactions

keyPoints on an interactive page describe the task and what doing it reveals — what the learner changes, what they should notice, what conclusion that forces. Not facts to be read aloud.

Show full SKILL.md (408 more words)Show less

Narration is facilitation

This is where the style is heard, so it is the part to get right.

  • Lines are short — one or two sentences. Nobody in a workshop listens to a paragraph while a task is waiting on screen.
  • Ask more than you tell. Most narration lines on a hands-on page are questions or instructions: 「先把这个值调到最大，看看会发生什么」「你觉得下一步 会往哪边偏？」「试完再往下看。」 Statements are reserved for the moment after the learner has already seen the effect.
  • Hand the work over and get out of the way. Say what to do, then stop. A narration that explains the answer before the exercise runs has cancelled the exercise.
  • Two voices, in dialogue. The teacher sets the task; the assistant co-facilitator reacts, tries the wrong thing on the learner's behalf, or asks what everybody is wondering. Alternating short turns, not monologue.
  • Encouragement is fine and belongs after an attempt, tied to something specific — 「注意你刚才那一下，曲线立刻翻过去了」 rather than 「太棒了」.

The roster

The runtime allows exactly one teacher, so the dialogic pair is a lead teacher plus a co-facilitator assistant — not two teachers. Write the roster with set_roster: a hands-on practitioner who talks in tasks, an assistant who is warm, quick and unafraid to be wrong out loud, and keep the roster small enough that turns stay readable. Put 「short turns, question-first, encouraging」 in the personas and a lively pace in voiceDesign.delivery.

Carrying the style into the generators

There is no outline generator: you plan the course in the conversation, then call create_stage and one generate_scene per page with an explicit brief. Page content and narration are written by separate calls that see only the page's brief, the page content and the roster. So the style has to be carried there explicitly:

  • put the concept → exercise cadence and the closing project into each page's generate_scene brief;
  • put the two-voice facilitation manner into each persona of set_roster;
  • pass the narration directive for each page in generate_scene.materialFacts — e.g. 「旁白为引导式短句，一到两句一条，提问多于陈述」「本页先让学员动手， 结论留到操作之后」. Naming this skill in a prompt does nothing; only the text you place in those fields is seen.

Scene naming

Titles name what the learner does, in the imperative.

  • Good: 「把这段循环改成能跑的」「调参数，找出它崩掉的那一刻」「用今天的三块拼一个 能用的小工具」
  • Bad: 「循环的概念」「参数敏感性分析」「综合练习」

If the request is not a workshop

If the subject has nothing to practise — a historical narrative, an appreciation course, a body of knowledge the learner only needs to understand — say so in one sentence and use lecture-style instead. Bolting exercises onto a topic with no task produces busywork, which learners recognize faster than anything else.

© THU-MAIC, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/agent-runtime/workshop-style of THU-MAIC/OpenMAIC.

  • SKILL.md
  • outline-constraints.json

Open the folder on GitHubat commit 6a84dbe

Compare with similar skills

Workshop-Style Course Design next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Workshop-Style Course Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Workshop-Style Course Design this skillTHU-MAIC/OpenMAIC40k—~1.5kAutomated safety check: PassMIT
HTML Ppt Course Modulesanqiufong/slides-from-anything132—~1.1kAutomated safety check: PassApache-2.0
AI Engineering Placement Quizrohitg00/ai-engineering-from-scratch66k—~2kAutomated safety check: PassMIT
AnythingAtlasLiuziyu77/AnythingAtlas195—~3.6kAutomated safety check: PassApache-2.0
Codex Skill Self-AssessmentFlorianBruniaux/claude-code-ultimate-guide6.1k—~2.3kAutomated safety check: PassCC-BY-SA-4.0
Claude Academy Guideanthropics/skills180k3 repos~1.9kAutomated safety check: PassApache-2.0

Similar skills

  • HTML Ppt Course Module

    sanqiufong/slides-from-anything

    Online-course / workshop module deck — warm paper background + Playfair serif, persistent left sidebar of learning objectives, MCQ self-check page.

    132 GitHub stars~1.1k tokensUpdated today
    EducationAuto-check passed

  • AI Engineering Placement Quiz

    rohitg00/ai-engineering-from-scratch

    Runs a 10-question quiz across five areas to place a learner in the AI Engineering from Scratch curriculum, so they skip what they already know.

    66k GitHub stars~2k tokensUpdated today
    EducationAuto-check passed

  • AnythingAtlas

    Liuziyu77/AnythingAtlas

    Researches an unfamiliar topic and delivers a verified resource guide and a staged, timed learning roadmap as matching Markdown and HTML files.

    195 GitHub stars~3.6k tokensUpdated 1 mo ago
    EducationAuto-check passed

  • Codex Skill Self-Assessment

    FlorianBruniaux/claude-code-ultimate-guide

    Runs an interactive quiz in a quick or comprehensive mode, scores your skill level by topic and generates a personalized learning path with practice projects.

    6.1k GitHub stars~2.3k tokensUpdated yesterday
    EducationAuto-check passed

  • Claude Academy Guide

    anthropics/skills

    Official

    Adds a matching Claude Academy course, tutorial or use case to the end of an answer about learning to use Claude, but only when the match is strong.

    180k GitHub starsUsed in 3 repos~1.9k tokens
    EducationAuto-check passed

  • Lecture Performance Review

    cat-xierluo/legal-skills

    Analyzes raw lecture transcripts for verbal tics, pacing, time use and promise follow-through, with optional slide-by-slide comparison and cross-session tracking.

    717 GitHub stars~2.2k tokensUpdated today
    EducationAuto-check passed

More from THU-MAIC/OpenMAIC

All 25 skills in this repo

  • OpenMAIC Setup and Extension

    THU-MAIC/OpenMAIC

    Guides setup, classroom generation and secondary development for OpenMAIC, the multi-agent interactive classroom, one confirmed phase at a time.

    40k GitHub stars~1.7k tokensUpdated today
    Auto-check: notes

  • K-12 Core Literacy Lesson Design

    THU-MAIC/OpenMAIC

    Designs a Chinese K-12 classroom for one OpenMAIC stage around the core-literacy model, using authentic tasks, performance assessment and observable evidence.

    40k GitHub stars~2.4k tokensUpdated today
    Auto-check passed

  • OpenMAIC Stage Document Map

    THU-MAIC/OpenMAIC

    Maps the structure of an OpenMAIC stage document so an agent can find the right path, read it and patch quizzes, widgets, actions and project pages without guessing.

    40k GitHub stars~2.4k tokensUpdated today
    Auto-check passed

  • Zone of Proximal Development Practice Lessons

    THU-MAIC/OpenMAIC

    Designs a review-and-practice lesson around an independent first attempt, targeted feedback, supported practice, a fresh independent check and a next step.

    40k GitHub stars~1.1k tokensUpdated today
    Auto-check passed

  • Build A Personal Skill From History

    THU-MAIC/OpenMAIC

    Derives a reusable personal skill for course-making from a representative sample of the user's own past classrooms and chat history, confirmed with them before saving.

    40k GitHub stars~678 tokensUpdated today
    Auto-check passed

  • Curriculum Planner

    THU-MAIC/OpenMAIC

    Plans a multi-classroom series such as a seven-day course, clarifies the brief in rounds, gets sign-off on the full lesson list, then builds each stage in a shared folder.

    40k GitHub stars~2.8k tokensUpdated today
    Auto-check passed

Categories

Questions about Workshop-Style Course Design

What does Workshop-Style Course Design do?

Shapes a course as a hands-on workshop, with an exercise or check every couple of pages, short task-brief slides and a closing page that combines the pieces into a small project. The learner works through the course rather than watching it. Scene one is a short slide stating what they will have made by the end and the first thing to try, and from then on every concept is followed at once by a hands-on page, roughly one interactive or quiz page for every two pages.

When should I use Workshop-Style Course Design?

Workshop-Style Course Design fits situations like: designing a workshop or bootcamp session where learners build as they go; turning a lecture outline into a learn-by-doing course; planning a closing project that combines the earlier exercises.

How do I install Workshop-Style Course Design in Claude Code?

Run `npx skills add THU-MAIC/OpenMAIC --skill workshop-style -a claude-code`. Or copy the skill folder (skills/agent-runtime/workshop-style in THU-MAIC/OpenMAIC) into .claude/skills/workshop-style in your project. Claude Code loads it when a task matches its description.

How do I install Workshop-Style Course Design in Codex?

Run `npx skills add THU-MAIC/OpenMAIC --skill workshop-style -a codex`. Or copy the skill folder (skills/agent-runtime/workshop-style in THU-MAIC/OpenMAIC) into .agents/skills/workshop-style in your project. Codex loads it when a task matches its description.

Can I use Workshop-Style Course Design in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add THU-MAIC/OpenMAIC --skill workshop-style -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/workshop-style, .gemini/skills/workshop-style, .github/skills/workshop-style and .opencode/skills/workshop-style in your project.

What does Workshop-Style Course Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Workshop-Style Course Design is instructions for the agent only. Our summary lists: The OpenMAIC course runtime and its stage-design skill.

Does Workshop-Style Course Design access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Workshop-Style Course Design safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Workshop-Style Course Design use?

Workshop-Style Course Design is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Workshop-Style Course Design use?

About 1.5k tokens (SKILL.md is roughly 6.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Workshop-Style Course Design?

Skills that share tags, products or a category with Workshop-Style Course Design: HTML Ppt Course Module (sanqiufong/slides-from-anything, 132 stars), AI Engineering Placement Quiz (rohitg00/ai-engineering-from-scratch, 66k stars), AnythingAtlas (Liuziyu77/AnythingAtlas, 195 stars) and Codex Skill Self-Assessment (FlorianBruniaux/claude-code-ultimate-guide, 6.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Workshop-Style Course Design?

THU-MAIC (a GitHub organization) maintains it in THU-MAIC/OpenMAIC, which has 40,213 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 9, 2026.

Source: THU-MAIC/OpenMAIC on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.