teaching-minigames

teaching-minigames is a skill for Claude Code, Codex from mathruffian-dot/teaching-exam-skills. It costs 187 tokens per session (2,442 once invoked), scanned A, original, MIT.

A teaching tool that turns uploaded materials such as PDFs, images, Word files, or text into small interactive learning games. It creates one formative assessment game for each key point and publishes shareable HTML pages with QR codes.

In plain words
What is it for?
Use it to make quizzes, matching activities, fill-in exercises, true-or-false questions, ordering tasks, or memory games from teaching materials.
Why use it?
It removes the work of extracting teachable points, writing questions, and building separate web activities.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to make quizzes, matching activities, fill-in exercises, true-or-false questions, ordering tasks, or memory games from teaching materials.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/mathruffian-dot/teaching-exam-skills/teaching-minigames
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add mathruffian-dot/teaching-exam-skills --skill teaching-minigames
Clone the repo
git clone --depth 1 https://github.com/mathruffian-dot/teaching-exam-skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for teaching-minigames

README.md
[![agentmods](https://agentmods.dev/badge/skills/mathruffian-dot/teaching-exam-skills/teaching-minigames/github.svg)](https://agentmods.dev/skills/mathruffian-dot/teaching-exam-skills/teaching-minigames)
Your own site
<a href="https://agentmods.dev/skills/mathruffian-dot/teaching-exam-skills/teaching-minigames"><img src="https://agentmods.dev/badge/skills/mathruffian-dot/teaching-exam-skills/teaching-minigames/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for teaching-minigames

Your own site · 80×15
<a href="https://agentmods.dev/skills/mathruffian-dot/teaching-exam-skills/teaching-minigames"><img src="https://agentmods.dev/badge/skills/mathruffian-dot/teaching-exam-skills/teaching-minigames.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 187 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,442 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00187 $0.02442
Opus 5 $0.00093 $0.01221
Sonnet 5 $0.00037 $0.00488
Haiku 4.5 $0.00019 $0.00244

Measured 7d ago against content hash 1e480e846ad1, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-11, from the pricing page.

Security

Grade A, and why

teaching-minigames scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/teaching-minigames/SKILL.md · 231 lines

How it starts

The opening of the file, as written. The whole thing — 231 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Teaching Material Mini-Games Skill

將教材自動轉換為「一重點一小遊戲」的形成性評量網頁,附 QR Code 讓教師在任何數位平台快速使用。


整體工作流程

1. 分析教材 → 2. 提取重點清單(確認) → 3. 製作小遊戲 HTML
→ 4. 打包索引頁 → 5. 自動上傳 GitHub → 6. 啟用 GitHub Pages
→ 7. 回傳每個遊戲的網址 + QR Code

Step 1:分析教材,提取重點

讀取使用者上傳的教材(PDF / 圖片 / .docx / 純文字)。 用以下框架萃取「學習重點(Key Learning Points)」:

  • 每個重點 = 一個獨立、可測驗的知識單元
  • 命名格式:重點N:[簡短標題]
  • 建議數量:3~10 個(依教材密度決定)
  • 每個重點附上:核心概念、2~4 個測驗素材(答案、干擾選項、例句等)

在繼續前,先向使用者確認重點清單是否正確。


Step 2:選擇遊戲類型

根據每個重點的性質,從以下遊戲類型中挑選最合適的:

遊戲類型 適用情境 檔名
選擇題 (MCQ) 概念理解、定義 game-mcq.html
填充題 (Fill-in-Blank) 關鍵詞記憶、公式 game-fill.html
配對題 (Matching Pairs) 詞彙對應、因果關係 game-match.html
是非題 (True/False) 常見迷思澄清 game-tf.html
排序題 (Ordering) 步驟、時序、流程 game-order.html
記憶翻牌 (Memory Cards) 詞彙與圖像記憶 game-memory.html

每個重點可以使用不同類型,增加多樣性。


Step 3:製作每個小遊戲 HTML

每個遊戲必須是完全獨立的單一 HTML 檔案,不依賴外部伺服器。

HTML 結構規範

<!DOCTYPE html>
<html lang="zh-TW">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>[重點標題] - 小遊戲</title>
  <!-- 所有 CSS 內嵌於 <style> -->
</head>
<body>
  <!-- 遊戲內容 -->
  <!-- 所有 JS 內嵌於 <script> -->
</body>
</html>

必備 UI 元素

每個遊戲頁面都必須包含:

  • 標題:重點名稱
  • 說明:簡短遊戲規則(1 句話)
  • 遊戲區域:互動題目
  • 即時回饋:答對 ✅ 顯示鼓勵語,答錯 ❌ 顯示正確答案
  • 得分/進度顯示:例如「2 / 4 題」
  • 重玩按鈕

設計風格規範

  • 手機優先(行動裝置友善)
  • 字體大小 ≥ 16px
  • 按鈕夠大(min-height: 44px)
  • 配色使用高對比、清晰的教育風格
  • 不使用任何外部 CDN(純內嵌,離線可用)

詳細各類型遊戲的 HTML 模板請參考本技能目錄下的 references/game-templates.md


Step 4:製作總索引頁面

產生一個 index.html,作為所有小遊戲的入口:

  • 列出所有重點與對應遊戲連結
  • 顯示每個遊戲的 QR Code(使用 QR Code 嵌入方式,見下方)
  • 可印出 / 投影給學生使用

Step 5:QR Code 嵌入(在 HTML 內)

每個遊戲的 HTML 中嵌入會動態顯示自身 QR Code 的程式碼,讓使用者可在瀏覽器中直接顯示 QR Code:

<div class="qr-section">
  <img id="qr-img" width="150" height="150" alt="QR Code">
  <p>掃描開啟此遊戲</p>
</div>
<script>
  // 發佈後自動顯示當前頁面的 QR Code
  document.getElementById('qr-img').src =
    'https://api.qrserver.com/v1/create-qr-code/?size=150x150&data='
    + encodeURIComponent(window.location.href);
</script>

Read the full file on GitHub · 231 lines

Files

What ships with it

2 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago Changed · -4 lines 1e480e846ad1
  2. 11d ago First seen · 235 lines · 187 tokens per session scan A f08f67db41f6

Subscribe to this mod's changes

teaching-minigames is a skill published in the GitHub repository mathruffian-dot/teaching-exam-skills (5 stars, last pushed 7d ago), licensed MIT. It adds 187 tokens to every session and 2,442 once invoked, about $0.0009 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

gentleman-trainer

Vim Trainer RPG system patterns for Gentleman.Dots. Trigger: When editing files in installer/internal/tui/trainer/, adding exercises, modules, or game mechanics.

Gentleman-Programming/Gentleman.Dots · 39 tokens

game-builder

Convert any topic into playable browser games. Types: trivia, matching, word puzzles, adventure games. Uses Phaser.js or Kaboom.js.

OneWave-AI/claude-skills · 31 tokens

teach-me

Teach the user end-to-end browser game development over multiple sessions — design, engine, art, audio, juice, multiplayer, shipping — by building real games together. Use when the user wants to LEARN to make games themselves: 'teach me game development', 'I want to learn to make games', 'teach me Phaser', 'how do…

kyh/vibedgames · 98 tokens

hr-game-development

Help HR and recruiting teams hire and assess game development candidates across engineering, design, and art disciplines. Use when asked to write a game developer job description, create a gameplay engineer interview, assess a game designers portfolio, build a game studio leveling framework, or similar…

tuanductran/hr-skills · 61 tokens

godot-genre-educational

Expert blueprint for educational games including gamification loops (learn/apply/feedback/adapt), progress tracking (student profiles, mastery %), adaptive difficulty (target 70% success rate), spaced repetition, curriculum trees (prerequisite system), and visual feedback (confetti, XP bars). Use for learning apps…

thedivergentai/GD-Agentic-Skills · 105 tokens

tutorial-workflow

A workflow for designing, reviewing, and testing tutorials and new-player onboarding for a game. It checks whether the tutorial teaches the game’s goals, turns, and cause-and-effect actions rather than merely listing buttons or reading like a rulebook.

zhuanggenhua/BoardGame · 39 tokens