# Vocational

Vocational / technical training courses.

- Repository: https://github.com/THU-MAIC/OpenMAIC (42385 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add THU-MAIC/OpenMAIC --skill vocational -g -a claude-code -y`
Codex: `npx skills add THU-MAIC/OpenMAIC --skill vocational -g -a codex -y`
Cursor: `npx skills add THU-MAIC/OpenMAIC --skill vocational -g -a cursor -y`
Gemini CLI: `npx skills add THU-MAIC/OpenMAIC --skill vocational -g -a gemini-cli -y`

## Description

Vocational / technical training courses. Plans the course as a hands-on work task with an operation flow, tool and equipment state, safety boundaries and GO/STOP judgements, instead of a concept lecture. Use when the requirement names a real occupational task, a piece of equipment, a clinical or industrial procedure, or a certification skill.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Vocational task-engine course design

You are designing a **vocational practice sequence**, not a lecture. The learner
is going to *do* the work, in order, with tools and state and consequences.

The learner-facing name for this mode is 「任务引擎」. Never expose internal
widget names to the learner, but the outline JSON must carry the real widget
contract the renderer needs.

## Structure

- Open with exactly one `slide`: the task briefing. It states the work task, its
  boundary, the training objective, the key steps, the safety boundary or risk
  reminder, and the completion criteria / GO-STOP standard. It is **not** a
  history-of-the-field or a definitions page.
- The body is a sequence of **operation stages** of the same task, in the order
  a technician would actually perform them: preparation and equipment check →
  the operation itself, step by step → verification, measurement or recording →
  handover / completion check.
- At least three body scenes must be `interactive` with
  `widgetType: "procedural-skill"`. These are the hands-on stages: the learner
  works through steps against tools and state, and gets consequences for unsafe
  or out-of-order actions.
- Include at least one `quiz` positioned as a **GO/STOP decision checkpoint**:
  given an abnormal reading or an unsafe condition, does the learner proceed,
  recheck, or stop. Not a vocabulary quiz.
- Close on the completion criteria, not on a summary of concepts.

## Scene naming

Scene titles read as work steps, not as topics.

- Good: 「断电确认与验电」「绝缘电阻测量与判读」「异常读数：继续还是停线」
- Bad: 「什么是低压配电柜」「配电柜的发展历史」「本课总结」

## procedural-skill widget outlines

For every `procedural-skill` scene fill `widgetOutline` with the real contract:

The rest: https://github.com/THU-MAIC/OpenMAIC/blob/HEAD/skills/agent-runtime/vocational/SKILL.md