DeepTutor CLI
HKUDS/DeepTutor
Teaches the agent to set up and run DeepTutor from the command line: chat and capabilities, knowledge bases, partners, memory, sessions, notebooks and the server or Web app.
1 本の速習資料では収まらない、章立ての学習資料（<topic-book/01-quickstart.md, 02-….md …）を、読み手のペルソナに合わせて設計・執筆・検証する。章ごとの学習目標と理解度チェックの対応、概念を導入より前に使わない順序、章の読了時間の予算、「未完成なら落ち、答えなら通る」演習、book.json から生成する章の依存図を、verify-book.mjs…
Install Explainer Book
$ npx skills add mizchi/explainer --skill explainer-book -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install mizchi/explainer explainer-book --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/mizchi/explainer.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/explainer-book .claude/skills/explainer-book && rm -rf skills-srcUse ~/.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/
Install the "explainer-book" agent skill from https://github.com/mizchi/explainer/tree/main/skills/explainer-book into .claude/skills/explainer-book/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explainer-book", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/mizchi/explainer/tree/main/skills/explainer-bookType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add mizchi/explainer --skill explainer-book -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install mizchi/explainer explainer-book --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mizchi/explainer.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/explainer-book .agents/skills/explainer-book && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "explainer-book" agent skill from https://github.com/mizchi/explainer/tree/main/skills/explainer-book into .agents/skills/explainer-book/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explainer-book", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mizchi/explainer --skill explainer-book -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install mizchi/explainer explainer-book --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mizchi/explainer.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/explainer-book .cursor/skills/explainer-book && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "explainer-book" agent skill from https://github.com/mizchi/explainer/tree/main/skills/explainer-book into .cursor/skills/explainer-book/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explainer-book", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/mizchi/explainer.git --path skills/explainer-book--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add mizchi/explainer --skill explainer-book -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install mizchi/explainer explainer-book --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mizchi/explainer.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/explainer-book .gemini/skills/explainer-book && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "explainer-book" agent skill from https://github.com/mizchi/explainer/tree/main/skills/explainer-book into .gemini/skills/explainer-book/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explainer-book", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install mizchi/explainer explainer-bookInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add mizchi/explainer --skill explainer-book -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/mizchi/explainer.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/explainer-book .github/skills/explainer-book && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "explainer-book" agent skill from https://github.com/mizchi/explainer/tree/main/skills/explainer-book into .github/skills/explainer-book/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explainer-book", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add mizchi/explainer --skill explainer-book -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install mizchi/explainer explainer-book --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/mizchi/explainer.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/explainer-book .opencode/skills/explainer-book && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "explainer-book" agent skill from https://github.com/mizchi/explainer/tree/main/skills/explainer-book into .opencode/skills/explainer-book/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "explainer-book", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
explainer-book- GitHub stars
- 414
- Token cost
- ~1k tokens
- SKILL.md length
- 182 words
- Files
- 3 (incl. scripts, references)
- Skills in repo
- 4
- Repo updated
- First seen
- Licence
- MIT
At a glance
1 本の速習資料では収まらない、章立ての学習資料（<topic-book/01-quickstart.md, 02-….md …）を、読み手のペルソナに合わせて設計・執筆・検証する。章ごとの学習目標と理解度チェックの対応、概念を導入より前に使わない順序、章の読了時間の予算、「未完成なら落ち、答えなら通る」演習、book.json から生成する章の依存図を、verify-book.mjs…
- Works in 5 steps: 学習目標 → 概念の順序 → 演習 → …
- The user asks for a book
- SKILL.md covers いつ本にするか, 構成, 手順 and やってはいけないこと, plus 1 more section
- Runs JavaScript scripts from its folder; calls node
What it does
Explainer Book is an agent skill from mizchi/explainer. 1 本の速習資料では収まらない、章立ての学習資料（<topic-book/01-quickstart.md, 02-….md …）を、読み手のペルソナに合わせて設計・執筆・検証する。章ごとの学習目標と理解度チェックの対応、概念を導入より前に使わない順序、章の読了時間の予算、「未完成なら落ち、答えなら通る」演習、book.json から生成する章の依存図を、verify-book.mjs で検査し、各章の出力・図・HTML は explainer の verify-doc.mjs で検査する。Use when the user asks for a book, a tutorial series, a course, "学習資料", "チュートリアル", "ハンズオン", "本にまとめて", "章立てで", "01-quickstart から", or when an explainer crash course would exceed ~20 minutes or needs exercises.
Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts and reference files (for example `references/book-json.md`).
It sits in Education. The licence is MIT.
When your agent uses it
- The user asks for a book
- A tutorial series
- 01-quickstart から
- An explainer crash course would exceed ~20 minutes
Example prompts
- “本にまとめて”
- “01-quickstart から”
- “/explainer-book”
Requirements
- Node.js
Workflow steps
5 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit 578defb. 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
Ships 1 file in scripts/ (JavaScript), which the agent can run.
Shell commands in SKILL.md call:
node
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
Explainer Book loads about 1k tokens when it runs, and up to ~1.8k if it reads all its reference files. Until then it costs about 118 tokens; SKILL.md has 182 words of instructions outside code blocks.
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); the scripts in this folder are not scanned.
SKILL.md
The full file from mizchi/explainer at commit 578defb, republished under its MIT licence (© mizchi). 182 words, ~1,011 tokens.
Download SKILL.mdSave it as
.claude/skills/explainer-book/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.- name
- explainer-book
- description
- 1 本の速習資料では収まらない、章立ての学習資料（<topic>-book/01-quickstart.md, 02-….md …）を、読み手のペルソナに合わせて設計・執筆・検証する。章ごとの学習目標と理解度チェックの対応、概念を導入より前に使わない順序、章の読了時間の予算、「未完成なら落ち、答えなら通る」演習、book.json から生成する章の依存図を、verify-book.mjs で検査し、各章の出力・図・HTML は explainer の verify-doc.mjs で検査する。Use when the user asks for a book, a tutorial series, a course, "学習資料", "チュートリアル", "ハンズオン", "本にまとめて", "章立てで", "01-quickstart から", or when an explainer crash course would exceed ~20 minutes or needs exercises.
explainer-book
explainer の本版。
1 本の速習資料（20 分以内・例 1 つずつ）で足りないとき、章に分けて、手を動かして身につける資料にする。
ペルソナ・図・検証の仕組みは explainer をそのまま使う。先に ../explainer/SKILL.md を読むこと。
このスキルが足すのは、本全体の設計と検査。
スクリプトは、このスキルのディレクトリ（以下 <skill>）の scripts/ にあります。
verify-book.mjs は、隣の explainer スキルの scripts/verify-doc.mjs を呼びます。2 つのスキルは同じ場所に入れてください。
依存の入れ方は explainer の「準備」と同じです。
いつ本にするか
次のどれかに当てはまったら本にする。1 つも当てはまらなければ、explainer の 1 本で書く。
- 読了が 20 分を超える
- 読み手が手を動かす演習が要る（読むだけでは「判定できる」ようにならない）
- 概念に順序がある（A を知らないと B が読めない）
構成
<topic>-book/
README.md 目次：想定読者、章ごとの「読み終えたらできること」、章の依存図、再現方法
book.json 章の順序・学習目標・導入する概念・演習（references/book-json.md）
01-quickstart.md 最初の章は必ず quickstart：理論の前に、動く結果に着く
02-….md concept：1 章 1 つの判定を身につける
03-….md practice：演習が中心
checks.json 本文の出力と演習の答えを再生成するコマンド（explainer と同じ形式）
examples/ 章で使うコード・モデル。演習の出発点と答えを別ファイルにする
figures/ book-map.*（生成）と各章の図手順
1. ペルソナ explainer と同じ。「怪しいところ」から、本全体の問いを 1 つ決める
2. 目標を並べる 問いに答えるために読み手ができるべき判定を 3〜6 個。1 章に 1〜2 個
3. 概念の順序 各判定に要る概念を書き出し、どの章で導入するかを決める（book.json introduces / requires）
4. 実物を先に 各章の例と演習を作り、走らせる。演習は「出発点で落ちる」「答えで通る」を両方確かめる
5. 章を書く explainer の writing.md の型。章の冒頭に所要時間とゴール、末尾に理解度チェック
6. 検証 node <skill>/scripts/verify-book.mjs <book-dir> [--write]
7. 読ませる first-reader で、少なくとも 01-quickstart と演習の章を、ペルソナ本人に読ませる（explainer の手順 8）
8. 渡す dist/index.html と、各章の 1 行要約。未検証の点を明記2. 学習目標
目標は「読み終えたら、何を判定できるか」で書く。「〜を理解する」は検査できないので書かない。
- 悪い例：「CTI を理解する」
- 良い例：「CTI が出たとき、条件が弱すぎるだけか、性質が本当に破れるかを TLC で判定できる」
各目標には、理解度チェックの問いを 1 つ以上付ける（<!-- quiz: <目標id> -->）。
3. 概念の順序
- ペルソナが既に知っている概念は
assumedに書く。説明しない。 - それ以外の概念は、ちょうど 1 つの章が
introducesする。その章より前の章の本文に出てきたら、検証が落ちる。 - 章が前提にする概念は
requiresに書く。依存図の矢印になる。
4. 演習
演習の答えも実行して確かめる。答えが間違った演習は、間違いを教える。
| kind | 例 | 検査 |
|---|---|---|
write | 条件・関数・設定を書かせる | starter：出発点のまま実行すると落ちることを確かめる check。answer：答えで通ることを確かめる check |
check | 道具を回して判定させる | answer：判定の根拠になる出力を再生成する check |
- 答えは、演習と同じ節の
<details>に入れる。 - 演習の前に
<!-- exercise: <id> -->を置く。
5. 章を書く
explainer の文体に加えて、次を守る。
- 冒頭の引用ブロックに、所要時間・ゴール（その章の目標）・前提（前の章）を書く。
- 末尾で次の章へリンクする（
→ [02 …](02-….md)）。HTML では前後の章と目次へのナビが付く。 - 前の章の結果を使うときは、章番号で参照する（「1 章の 3 つの check」）。同じ説明を繰り返さない。
- 手で推論した結果（「この状態には着けない」「この順序で起きる」）は、道具の出力に置き換える。推論は外れる。
6. 検証
node <skill>/scripts/verify-book.mjs <book-dir> # 検査
node <skill>/scripts/verify-book.mjs <book-dir> --write # 依存図と SVG を作り直す本全体の検査：
| 検査 | 落ちる条件 |
|---|---|
| chapters | 章ファイルがない。NN- の番号が book.json の順と違う。1 章が quickstart でない |
| objectives | quiz が付いていない目標がある。quiz が他の章の目標を名指ししている |
| concepts | 概念を導入より前の章で使っている。requires が導入されていない。introduces と宣言したのに本文に出てこない |
| budget | 本文の推定読了時間（500 字/分 + コード 15 行/分）が minutes を超える |
| exercises | 印がない。答えが <details> にない。check が checks.json にない。write 演習に落ちる starter がない |
| map | figures/book-map.* が book.json と一致しない。README に図がない |
そのあと、README と全章を verify-doc.mjs --pages に渡す。出力の引用、図、ページ間リンク、各ページの vlmkit ゲートを検査する。
book verdict: VERIFIED になるまで直す。
やってはいけないこと
- 章を増やして薄める。 1 章に目標がない、または理解度チェックが目標を問わないなら、その章は要らない。
- 演習の答えを走らせない。
- 前の章の説明を繰り返す。 章番号で参照する。
- 検証を通すために言い換える。 概念の検査に落ちたら、定義を前の章に移すか、章の順序を見直す。同義語に置き換えて逃げない。
ファイル
| パス | 内容 |
|---|---|
references/book-json.md | book.json の全フィールド |
scripts/verify-book.mjs | 本全体の検査 → verify-doc.mjs |
../explainer/scripts/build-html.mjs | 複数ページを HTML に（目次・前後の章へのナビつき） |
© mizchi, 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 2 other files (scripts, references) in skills/explainer-book of mizchi/explainer.
- SKILL.md
- references/book-json.md
- scripts/verify-book.mjs
Open the folder on GitHubat commit 578defb
Compare with similar skills
Explainer Book 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Explainer Book this skillmizchi/explainer | 414 | — | ~1k | Automated safety check: Pass | MIT | |
| DeepTutor CLIHKUDS/DeepTutor | 41k | — | ~2.3k | Automated safety check: Pass | Apache-2.0 | |
| Zhang Xuefeng Perspectivealchaincyf/zhangxuefeng-skill | 10k | 1 repos | ~2.6k | Automated safety check: Pass | MIT | |
| Deep Reading Analystginobefun/deep-reading-analyst-skill | 353 | 5 repos | ~3.6k | Automated safety check: Pass | MIT | |
| AI Engineering Placement Quizrohitg00/ai-engineering-from-scratch | 65k | — | ~2k | Automated safety check: Pass | MIT | |
| OpenMAIC Setup and ExtensionTHU-MAIC/OpenMAIC | 40k | — | ~1.7k | Automated safety check: Notes | MIT |
Similar skills
Zhang Xuefeng Perspective
alchaincyf/zhangxuefeng-skill
Answers education and career questions in the voice of Zhang Xuefeng, looking up current employment and admissions data before giving a direct verdict.
Deep Reading Analyst
ginobefun/deep-reading-analyst-skill
Comprehensive framework for deep analysis of articles, papers, and long-form content using 10+ thinking models (SCQA, 5W2H, critical thinking, inversion, mental models, first principles, systems…
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.
OpenMAIC Setup and Extension
THU-MAIC/OpenMAIC
Guides setup, classroom generation and secondary development for OpenMAIC, the multi-agent interactive classroom, one confirmed phase at a time.
Codebase to Course
zarazhangrui/codebase-to-course
Turns a codebase into an interactive single-page HTML course for non-technical learners, with scroll modules, animated diagrams, quizzes and plain-English code translations.
More from mizchi/explainer
Explainer
mizchi/explainer
特定の読み手に向けて、概念・PR・設計を「冗長にならない水準」の速習資料として説明し、図と主張を道具で検証する。読み手のペルソナ（既に知っていること・知らないこと・読み方）を質問と公開情報から作り、その差分だけを書く。図は Mermaid / D2 で描いて事実シートに照らし、本文に引用するコード・出力は再実行して照合し、HTML は vlmkit のゲートに通す。Use when the…
First Reader
mizchi/explainer
Beta readers for any draft, run by simulating how a real reader experiences it, moment by moment.
D2 Slides
mizchi/explainer
Build a slide deck whose source is text and whose figures are laid out by TALA — one Markdown file with a d2 fence per figure, compiled to a self-contained HTML deck (keyboard nav, overview grid…
Related
Categories
Questions about Explainer Book
What does Explainer Book do?
1 本の速習資料では収まらない、章立ての学習資料（<topic-book/01-quickstart.md, 02-….md …）を、読み手のペルソナに合わせて設計・執筆・検証する。章ごとの学習目標と理解度チェックの対応、概念を導入より前に使わない順序、章の読了時間の予算、「未完成なら落ち、答えなら通る」演習、book.json から生成する章の依存図を、verify-book.mjs…. Explainer Book is an agent skill from mizchi/explainer.mjs で検査する。Use when the user asks for a book, a tutorial series, a course, "学習資料", "チュートリアル", "ハンズオン", "本にまとめて", "章立てで", "01-quickstart から", or when an explainer crash course would exceed ~20 minutes or needs exercises.
When should I use Explainer Book?
Explainer Book fits situations like: the user asks for a book; A tutorial series; 01-quickstart から; an explainer crash course would exceed ~20 minutes.
How do I install Explainer Book in Claude Code?
Run `npx skills add mizchi/explainer --skill explainer-book -a claude-code`. Or copy the skill folder (skills/explainer-book in mizchi/explainer) into .claude/skills/explainer-book in your project. Claude Code loads it when a task matches its description.
How do I install Explainer Book in Codex?
Run `npx skills add mizchi/explainer --skill explainer-book -a codex`. Or copy the skill folder (skills/explainer-book in mizchi/explainer) into .agents/skills/explainer-book in your project. Codex loads it when a task matches its description.
Can I use Explainer Book 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 mizchi/explainer --skill explainer-book -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/explainer-book, .gemini/skills/explainer-book, .github/skills/explainer-book and .opencode/skills/explainer-book in your project.
What does Explainer Book need to run?
Going by SKILL.md and its folder, Explainer Book needs JavaScript for the scripts in its folder and the command-line tools its instructions call (node). Our summary lists: Node.js.
Does Explainer Book 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 Explainer Book 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Explainer Book use?
Explainer Book 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 Explainer Book use?
About 1k tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 817 tokens, read only when the agent opens those files.
What are the alternatives to Explainer Book?
Skills that share tags, products or a category with Explainer Book: DeepTutor CLI (HKUDS/DeepTutor, 41k stars), Zhang Xuefeng Perspective (alchaincyf/zhangxuefeng-skill, 10k stars), Deep Reading Analyst (ginobefun/deep-reading-analyst-skill, 353 stars) and AI Engineering Placement Quiz (rohitg00/ai-engineering-from-scratch, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Explainer Book?
mizchi (a GitHub user) maintains it in mizchi/explainer, which has 414 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on October 6, 2026.
Source: mizchi/explainer on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.