Agent skill

Vocational Task-Engine Course Design

by THU-MAIC in THU-MAIC/OpenMAIC

Plans vocational training as a hands-on work task with operation stages, tool and equipment state, safety boundaries and GO or STOP checkpoints instead of a lecture.

MITAuto-check passedEducation

Install Vocational Task-Engine Course Design

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

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

GitHub CLI
$ gh skill install THU-MAIC/OpenMAIC vocational --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/vocational .claude/skills/vocational && 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
vocational
GitHub stars
40k
Token cost
~794 tokens
SKILL.md length
389 words
Files
2
Skills in repo
25
Repo updated
First seen
Licence
MIT

At a glance

Plans vocational training as a hands-on work task with operation stages, tool and equipment state, safety boundaries and GO or STOP checkpoints instead of a lecture.

  • Designing training for a real occupational task or piece of equipment
  • SKILL.md covers Structure, Scene naming, procedural-skill widget outlines and Prohibited, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Building a course around a clinical or industrial procedure

What it does

For courses about a real occupational task, a piece of equipment, a clinical or industrial procedure or a certification skill, this skill designs a practice sequence the learner performs in order. It opens with exactly one slide that serves as the task briefing: the task and its boundary, the objective, the key steps, a safety reminder and the completion criteria with a GO or STOP standard. It is explicitly not a history or definitions page.

The body follows the stages a technician would work through, from preparation and equipment check to the operation, then verification, measurement or recording, then handover. At least three scenes must be interactive procedural-skill widgets whose outlines name the procedure type (repair, assembly, inspection, operation or custom), the task, tools, ordered steps, success criteria and error consequences, and at least one quiz must be a GO or STOP decision checkpoint on an abnormal reading. Scene titles read as work steps, the course closes on completion criteria, and pure theory scenes and generic summary slides are prohibited.

When your agent uses it

  • Designing training for a real occupational task or piece of equipment
  • Building a course around a clinical or industrial procedure
  • Preparing certification skill practice with safety boundaries

Example prompts

  • “Design a course on insulation resistance testing of a low-voltage distribution cabinet.”
  • “Plan hands-on training for changing a hydraulic hose, with safety checkpoints.”
  • “Build a procedure course for calibrating a lab pH meter, ending on completion criteria.”

Requirements

  • The OpenMAIC course runtime that renders procedural-skill widgets

What it can do on your machine

Read from SKILL.md and the folder at commit 4c67608. 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

Vocational Task-Engine Course Design loads about 794 tokens when it runs. Until then it costs about 89 tokens; SKILL.md has 389 words of instructions outside code blocks.

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

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 4c67608, republished under its MIT licence (© THU-MAIC). 389 words, ~794 tokens.

Download SKILL.mdSave it as .claude/skills/vocational/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
vocational
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.
title
职业实训

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: 「什么是低压配电柜」「配电柜的发展历史」「本课总结」
Show full SKILL.md (160 more words)Show less

procedural-skill widget outlines

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

  • procedureType: one of repair, assembly, inspection, operation, custom
  • task: the concrete stage being performed
  • tools: the actual tools, instruments, PPE or materials the stage needs
  • steps: the ordered operations of that stage
  • successCriteria: how the learner knows the stage passed — thresholds, readings, states, not "understood the concept"
  • errorConsequences: what actually goes wrong if a step is skipped or done unsafely

Prohibited

  • Pure theory scenes, concept lectures, formula derivations.
  • Generic 「课程总结」/「回顾」 closing slides.
  • Making every hands-on scene the same checklist. Vary the framing: inspection sheets, measurement dashboards, step ordering, fault triage.

If the requirement is not vocational

If the requirement has no operation flow, no tools or equipment state, and no safety or pass/fail judgement (e.g. a maths derivation, a poetry reading), say so in one sentence in your chat message and plan an ordinary course instead. Do not force procedural-skill onto a topic that has no procedure.

© 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/vocational of THU-MAIC/OpenMAIC.

  • SKILL.md
  • outline-constraints.json

Open the folder on GitHubat commit 4c67608

Compare with similar skills

Vocational Task-Engine 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.

Vocational Task-Engine Course Design compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Vocational Task-Engine Course Design this skillTHU-MAIC/OpenMAIC40k—~794Automated safety check: PassMIT
HTML Ppt Course Modulesanqiufong/slides-from-anything132—~1.1kAutomated safety check: PassApache-2.0
AI Engineering Placement Quizrohitg00/ai-engineering-from-scratch67k—~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 yesterday
    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.

    67k 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 today
    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.

    721 GitHub stars~2.2k tokensUpdated yesterday
    EducationAuto-check passed

More from THU-MAIC/OpenMAIC

All 25 skills in this repo
  • 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
  • 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
  • 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
  • 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
  • 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 Vocational Task-Engine Course Design

What does Vocational Task-Engine Course Design do?

Plans vocational training as a hands-on work task with operation stages, tool and equipment state, safety boundaries and GO or STOP checkpoints instead of a lecture. For courses about a real occupational task, a piece of equipment, a clinical or industrial procedure or a certification skill, this skill designs a practice sequence the learner performs in order. It opens with exactly one slide that serves as the task briefing: the task and its boundary, the objective, the key steps, a safety reminder and the completion criteria with a GO or STOP standard.

When should I use Vocational Task-Engine Course Design?

Vocational Task-Engine Course Design fits situations like: designing training for a real occupational task or piece of equipment; building a course around a clinical or industrial procedure; preparing certification skill practice with safety boundaries.

How do I install Vocational Task-Engine Course Design in Claude Code?

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

How do I install Vocational Task-Engine Course Design in Codex?

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

Can I use Vocational Task-Engine 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 vocational -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/vocational, .gemini/skills/vocational, .github/skills/vocational and .opencode/skills/vocational in your project.

What does Vocational Task-Engine Course Design need to run?

SKILL.md names no scripts, command-line tools or credentials: Vocational Task-Engine Course Design is instructions for the agent only. Our summary lists: The OpenMAIC course runtime that renders procedural-skill widgets.

Does Vocational Task-Engine 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 Vocational Task-Engine 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 Vocational Task-Engine Course Design use?

Vocational Task-Engine 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 Vocational Task-Engine Course Design use?

About 794 tokens (SKILL.md is roughly 3.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 Vocational Task-Engine Course Design?

Skills that share tags, products or a category with Vocational Task-Engine Course Design: HTML Ppt Course Module (sanqiufong/slides-from-anything, 132 stars), AI Engineering Placement Quiz (rohitg00/ai-engineering-from-scratch, 67k 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 Vocational Task-Engine Course Design?

THU-MAIC (a GitHub organization) maintains it in THU-MAIC/OpenMAIC, which has 40,347 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 11, 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.