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.
npx skills add mathruffian-dot/teaching-exam-skills --skill teaching-minigamesgit clone --depth 1 https://github.com/mathruffian-dot/teaching-exam-skillsWrote 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.
[](https://agentmods.dev/skills/mathruffian-dot/teaching-exam-skills/teaching-minigames)<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.
<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>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.
| Model | Per session | Once 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 |
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.
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>
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.
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.
- 7d ago Changed · -4 lines 1e480e846ad1
- 11d ago First seen · 235 lines · 187 tokens per session scan A f08f67db41f6
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.
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.
game-builder
Convert any topic into playable browser games. Types: trivia, matching, word puzzles, adventure games. Uses Phaser.js or Kaboom.js.
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…
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…
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…
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.