bilingual-courseware
Skill34 starsChanged 5 months agoMITView on GitHub
Bilingual course-material maintenance for university professors — default EN ⇄ 简体中文, language-pair agnostic. 4-agent team covering the course terminology glossary (the contract every translation binds to), glossary-bound translation with pedagogical-equivalence checks, paired-version synchronization with drift detection, and read-only terminology consistency audits. Triggers on: translate course materials, bilingual course, English-medium instruction, EMI, terminology glossary, Chinese version, parallel syllabus, 双语教学, 双语课程, 全英文授课, 术语表, 专业术语, 翻译课件, 中英对照, 中文版.
In this repository15 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- accreditation-mapperSkill
- assessment-architectSkill
- cohort-analystSkill
- course-designerSkill
- course-publisherSkill
- deck-studioSkill
- lab-forgeSkill
- lesson-builderSkill
- media-scripterSkill
- student-mentorSkill
- submission-auditorSkill
- ta-coordinatorSkill
- teaching-pipelineSkill
- teaching-reflectorSkill
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 99
Glossary-first: No translation of term-bearing material without confirmed glossary coverage.
- Distinctive: line 113
Version pairing is recorded: Every translated artifact records the exact source version it matches.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Bilingual Courseware — Terminology & Paired-Version Team
Maintains bilingual course materials with terminology discipline. Other skills produce the artifacts; this skill keeps their two language versions saying the same thing — same terms every time, same pedagogical demand on both sides, and a recorded pairing so that neither version quietly outruns the other. Default pair is EN ⇄ 简体中文 (the conventions file covers it deeply); any pair works with professor-supplied conventions.
Prime rule: the glossary is the contract. Translation without a confirmed glossary produces drift — the same concept rendered three ways across a semester, and 90 students learning the wrong standard term. Glossary-first is this skill's blueprint-first rule: no term-bearing material is translated until its terms are confirmed, and new terms encountered mid-translation pause for confirmation rather than being improvised inconsistently.
Quick Start
Build a terminology glossary for my machine learning course
Translate my syllabus into Chinese — the English version is the original
把这门课的教学大纲翻译成英文,专业术语要统一
I updated the English syllabus to v2 — bring the Chinese version up to date
检查我所有课件里的术语是否一致
Check whether my slides and exam use the glossary terms consistentlyModes
| Mode | Trigger intent | Output |
glossary | "Build/extend a glossary", new course going bilingual, new unit's terms, 术语表 | Course terminology glossary: candidate terms extracted from course materials, translations proposed with authority notes, professor confirms each entry; maintained artifact, versioned |
translate | "Translate X", 翻译课件 / 中文版 — one artifact: outcomes, syllabus, slides source, handouts, exam instructions | Glossary-bound translation + pedagogical-equivalence pass + divergence log + pairing-registry entry |
parallel | "Update the other version", "keep both in sync", 中英对照 maintenance | Paired-version create/update: change one side → propagate to the other; drift report when versions evolved independently |
check | "Are my terms consistent?", pre-semester sweep, 检查术语 | Read-only terminology consistency audit across ALL course materials in one language or across the pair — every finding located, no rewrites |
Mode dispatch rule: a translation request for an artifact whose domain terms are not
yet covered by a confirmed glossary routes through glossary first — on the new terms
only, incrementally, never a restart. Detect intent in any language.
Does NOT trigger
| Scenario | Use instead |
| Writing the original materials (syllabus, lessons, exams, scripts) | The producing skill: course-designer, lesson-builder, assessment-architect, media-scripter |
| Translating student-facing communications (announcements, emails, FAQ) | course-publisher, binding to this skill's glossary |
| General translation unrelated to a course | Out of scope for this suite |
Agent Team (4)
| Agent | Role |
glossary_keeper_agent | Extracts candidate terms, proposes pairs with authority notes, runs batched professor confirmation, maintains the versioned glossary other skills consume |
translator_agent | Glossary-bound translation with pedagogical-equivalence checks: cultural accessibility, difficulty shift, register, length expansion; logs every deliberate divergence |
parallel_sync_agent | Pairing registry, change propagation, three-way drift reports; professor chooses merge direction — never auto-merges |
terminology_auditor_agent | Read-only consistency audit: glossary violations, intra-language inconsistency, untranslated strays, script/punctuation discipline — every finding located |
Workflow (translate mode)
Phase 0 GLOSSARY GATE — check the confirmed glossary covers the artifact's domain
terms. Missing or stale coverage → `glossary` mode on the new
terms only (incremental — not a restart of the glossary)
Phase 1 DRAFT — translator_agent produces the glossary-bound translation with
pedagogical-equivalence notes: examples that don't cross
cultures flagged with a proposed local equivalent; instructions
whose difficulty shifts in translation flagged
Phase 2 TERM AUDIT — terminology_auditor_agent passes over the draft: every
confirmed term rendered exactly, near-misses are defects
🧑 checkpoint: translation + divergence log — every deliberate non-literal
choice listed with location and reason; the professor approves or redirects
Phase 3 REGISTER — parallel_sync_agent records the pairing: which exact version
of the source this translation matches, in the sync register
and passport artifacts[]glossary mode runs glossary_keeper end-to-end (extract → propose → 🧑 batched
confirmation → version). parallel mode diffs the changed side, translates the delta
through Phases 1–2, patches the pair, and updates the register; independently-evolved
sides produce a drift report instead of a patch. check mode runs
terminology_auditor_agent alone, read-only, findings located like submission-auditor.
Iron rules
- Glossary-first. No translation of term-bearing material without confirmed glossary coverage. A new term encountered mid-translation pauses for confirmation — it is never improvised inconsistently, because the improvisation becomes the term students learn.
- The professor confirms terminology. Discipline terminology is the professor's
domain. Candidate pairs ship with an authority basis — standard textbook usage,
national standards-body patterns, common EMI practice — but their status is
[NEEDS PROFESSOR INPUT]until confirmed. A wrong standard term taught to 90 students is expensive; a confirmation batch costs minutes. - Pedagogical equivalence over literalism. Translated artifacts must make the same pedagogical demand, not the same words. Divergences are deliberate and logged — location, what changed, why — never accidental. Assessment translations are checked for difficulty shift: an exam that is harder in one language is an equity defect, not a style choice.
- Version pairing is recorded. Every translated artifact records the exact source
version it matches. Sync status is checkable at any time; drift is loud. The
parallelmode exists because v2 of the English syllabus WILL forget the Chinese one — silence is the failure mode, the register is the cure. - Language-pair agnostic, EN⇄zh-CN tuned.
references/emi_conventions.mdcovers the default pair deeply — register, punctuation, authority hierarchy, code-switching. Other pairs work with professor-supplied conventions, recorded per course; the skill never pretends its zh-CN depth transfers automatically.
Outputs
bilingual/glossary.md— the confirmed terminology glossary (fromtemplates/glossary_template.md), versioned, consumed by other skillsbilingual/<artifact>_<lang>.md— translated artifacts, each with its divergence logbilingual/sync_register.md— pairing registry (fromtemplates/sync_register_template.md): what matches what, at which versionbilingual/drift_report.md(parallelmode, when sides evolved independently)bilingual/terminology_audit.md(checkmode) — located findings, ordered by student impact- Passport: paired artifacts cross-referenced in
artifacts[]
References
references/emi_conventions.md— EN⇄zh-CN register mapping, punctuation/typography, terminology authority hierarchy, assessment-translation equity, layout expansion, classroom code-switching conventionstemplates/glossary_template.mdtemplates/sync_register_template.md- Shared:
shared/course_passport_schema.md(notecourse.language_of_instruction),shared/checkpoint_protocol.md,shared/quality_gate_protocol.md
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

