explainer-book SKILL.md skillA
explainer-book from mizchi/explainer is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add mizchi/explainer/explainer-book@git:20260925.3356251Pins git:20260925.3356251 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- mizchi/explainer
- Path
skills/explainer-book/SKILL.md- Versions recorded
- 2
- Latest version
- git:20260925.3356251, committed Sep 25, 2026
- First version recorded
- Sep 25, 2026
- Size
- 7,751 bytes
- Repository stars
- 452
- License
- MIT
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.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# 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） …
Read the whole file at its exact version.
How to install
mdr add mizchi/explainer/explainer-book@sha256:3e6311339fe3be70The line at the top of this page pins the label git:20260925.3356251, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_5cdzmamlk26tomvd)
2 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 2 versions of this file, all committed on Sep 25, 2026.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260925.3356251 latest | 2026-09-25 | 3356251 | 7,751 B | A | view · diff |
| git:20260925.8e29cfb | 2026-09-25 | 8e29cfb | 7,301 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (7751 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
mizchi/explainer · 452 stars · license MIT · pushed 2026-10-10 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_5cdzmamlk26tomvd GET https://markdownregistry.com/api/v1/resolve?ref=mizchi/explainer/explainer-book GET https://markdownregistry.com/api/v1/blob/3e6311339fe3be70e1e86a17642d03f7bf02d594793d105ebc8a2cbe8deee769
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.