teaching-handbook

teaching-handbook is a skill for Claude Code, Codex from unbias38/my-claude-skills. It costs 225 tokens per session (3,974 once invoked), scanned A, original, MIT.

A converter that turns Word documents, Markdown files, or PowerPoint presentations into high-resolution HTML teaching pages with a fixed sidebar navigation.

In plain words
What is it for?
Use it to publish DOCX, Markdown, or PPTX handouts as navigable HTML pages with features such as scroll tracking, font-size controls, and code-copy buttons.
Why use it?
It provides a consistent web format for teaching material while preserving the source text, images, structure, and Word text colors. This avoids manually rebuilding the material as a webpage.

Skill for Claude CodeCodex

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

Good fit Use it to publish DOCX, Markdown, or PPTX handouts as navigable HTML pages with features such as scroll tracking, font-size controls, and code-copy buttons.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/unbias38/my-claude-skills/teaching-handbook
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 unbias38/my-claude-skills --skill teaching-handbook
Clone the repo
git clone --depth 1 https://github.com/unbias38/my-claude-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-handbook

README.md
[![agentmods](https://agentmods.dev/badge/skills/unbias38/my-claude-skills/teaching-handbook/github.svg)](https://agentmods.dev/skills/unbias38/my-claude-skills/teaching-handbook)
Your own site
<a href="https://agentmods.dev/skills/unbias38/my-claude-skills/teaching-handbook"><img src="https://agentmods.dev/badge/skills/unbias38/my-claude-skills/teaching-handbook/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-handbook

Your own site · 80×15
<a href="https://agentmods.dev/skills/unbias38/my-claude-skills/teaching-handbook"><img src="https://agentmods.dev/badge/skills/unbias38/my-claude-skills/teaching-handbook.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 225 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,974 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.00225 $0.03974
Opus 5 $0.00112 $0.01987
Sonnet 5 $0.00045 $0.00795
Haiku 4.5 $0.00022 $0.00397

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

Security

Grade A, and why

teaching-handbook 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 12d ago.

The scan reads SKILL.md. This mod also ships 5 executable files (scripts/_polish.py, scripts/docx_converter.py, scripts/md_converter.py, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

teaching-handbook/SKILL.md · 205 lines

How it starts

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

teaching-handbook

<SKILL_DIR> 代表本 SKILL.md 所在資料夾。

.docx / .md / .pptx 教學講義轉成側邊欄風格的教學網頁。

範圍邊界(重要)

本 skill 只負責機械轉檔(Stage 1):把原檔的文字、圖、結構忠實搬到 HTML,不改寫、不美化、不重組。

內容理解 / 改寫 / 美化(Stage 2)不在本 skill 範圍。原因:每份簡報的領域、讀者、風格差異太大,強行寫死自動規則只會把大部分簡報搞砸。Stage 2 由使用者在跑完轉檔後另起對話、依當份簡報的具體需求請 Claude 處理。

未來的維護者:不要把美化規則寫進這個 skill——本 skill 定位是忠實機械轉檔,美化屬於下游另一層。

若使用者指名 codelab / Codelabs 風格,本 skill 不處理,改用 codelab-handout(強意見視覺設計路線)。

硬規則(不可違反)

  1. 必須使用原始檔.docx / .md / .pptx),不接受先轉過的 .htm / .html(否則圖片會糊)。
  2. 不要改寫 scripts/ 下的 Python 邏輯,直接呼叫即可。
  3. 輸出檔名以輸入檔名為基底(例如 我的講義.docx我的講義.html),不要預設 index.html,避免覆蓋專案主頁。
  4. 若目標輸出檔已存在,先向使用者確認再覆蓋。

依套件

依賴由各腳本的 inline metadata(PEP 723)宣告,uv run 會自動安裝,無需手動裝套件。

執行 SOP

步驟 1:確認輸入檔

  • 使用者提供 .docx → 走 docx_converter.py
  • 使用者提供 .md → 走 md_converter.py
  • 使用者提供 .pptx → 走 pptx_converter.py
  • 其他副檔名 → 停下來問使用者

步驟 2:確認參數(都有預設值,可略)

  • --title:瀏覽器分頁標題(預設 教學手冊,md 預設 Document
  • --sidebar-title:側邊欄標題(docx 預設 教學手冊導航;pptx 預設 投影片目錄
  • --no-notes(僅 pptx):不納入講者備註。預設納入
  • 輸出檔名:省略則自動用輸入檔名 + .html

使用者若沒主動提,直接用預設值,不要反覆追問。

步驟 3:執行轉換

DOCX:

uv run <SKILL_DIR>/scripts/docx_converter.py "<input.docx>" --title "<標題>" --sidebar-title "<側邊欄標題>"

Markdown:

uv run <SKILL_DIR>/scripts/md_converter.py "<input.md>" --title "<標題>"

PPTX:

uv run <SKILL_DIR>/scripts/pptx_converter.py "<input.pptx>" --title "<標題>" --sidebar-title "<側邊欄標題>"

步驟 4:回報結果

告訴使用者輸出檔路徑,讓他可以打開檢查。不用自行開啟瀏覽器。

產出的網頁功能

  • 左側 280px 固定側邊欄,自動從 h1/h2/h3 生成目錄(Scroll Spy 高亮目前章節)
  • << 收折按鈕:側邊欄縮成 60px,主區域擴展到 1400px
  • A- / 100% / A+ 字體縮放(預設 1.15x)
  • 程式碼區塊(單格表格或 <pre>)自動加「複製」按鈕
  • 圖片響應式(max-width: 100%),保留 Word 原始高畫質

檔案結構

<SKILL_DIR>/
├── SKILL.md                      ← 本文件
└── scripts/
    ├── docx_converter.py         ← .docx 入口
    ├── md_converter.py           ← .md 入口
    ├── pptx_converter.py         ← .pptx 入口
    ├── style_injector.py         ← 核心樣式 + 導航 + 複製按鈕引擎(上游、不動)
    └── _polish.py                ← 共用 helper:sidebar 搜尋框 + 圖片 lazy load

Read the full file on GitHub · 205 lines

Files

What ships with it

6 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. 12d ago First seen · 205 lines · 225 tokens per session scan A d973501cb400

Subscribe to this mod's changes

teaching-handbook is a skill published in the GitHub repository unbias38/my-claude-skills (2 stars, last pushed 17d ago), licensed MIT. It adds 225 tokens to every session and 3,974 once invoked, about $0.0011 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

stuck

Diagnoses a broken course setup by reading the folder, so the student never has to describe the problem in English. Takes no argument. Reports which class they are on and which files are filled, then names one blocker and one fix: Claude Code opened at the wrong level, .claude/skills/ missing, skills not loading…

mshadmanrahman/claude-for-designers · 161 tokens

design-tokens

Establish color, typography, spacing, radius and motion as named role-based tokens. Use before building any interface.

mshadmanrahman/claude-for-designers · 27 tokens

frontend-design

Build an interface from the brief and the tokens rather than from a guess. Use only after grill-me, design-brief, information-architecture and design-tokens have run.

mshadmanrahman/claude-for-designers · 38 tokens

academic-slides

Create Beamer-inspired academic HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build slides for a conference talk, lecture, seminar, or thesis defense. Supports theorem environments, KaTeX equations, algorithm pseudocode, and citations. Helps academics discover their…

Nero1688/claude-academic-skills · 74 tokens

guiding-users

Implements onboarding and help systems including product tours, interactive tutorials, tooltips, checklists, help panels, and progressive disclosure patterns. Use when building first-time experiences, feature discovery, guided walkthroughs, contextual help, setup flows, or user activation features. Provides timing…

ancoleman/ai-design-components · 78 tokens

react-senior-interview

Interactive 10-question multiple-choice React interview, by theSeniorDev — drawn from the same principles as react-senior-code-review. Asks which level you're interviewing for (junior/mid/senior) and shifts difficulty to match. Per-question feedback. Final score with a breakdown by dimension and personalized study…

the-senior-dev/senior-dev-skills · 113 tokens