explainer SKILL.md skillA
explainer 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@git:20261010.c02cca9Pins git:20261010.c02cca9 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/SKILL.md- Versions recorded
- 12
- Latest version
- git:20261010.c02cca9, committed Oct 10, 2026
- First version recorded
- Sep 28, 2026
- Size
- 20,107 bytes
- Repository stars
- 452
- License
- MIT
特定の読み手に向けて、概念・PR・設計を「冗長にならない水準」の速習資料として説明し、図と主張を道具で検証する。読み手のペルソナ（既に知っていること・知らないこと・読み方）を質問と公開情報から作り、その差分だけを書く。図は Mermaid / D2 で描いて事実シートに照らし、本文に引用するコード・出力は再実行して照合し、HTML は vlmkit のゲートに通す。Use when the user says "explain this to me / to <person>", "速習資料", "解説ドキュメント", "この PR を理解したい", "わかるように説明して", "I can't keep up with what the agent wrote", "この PR を <人> が理解できるように説明して", or when a reviewer asks what a change does. Use it even for a small diff or a chat-only answer whenever a named reader…
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 人間の理解がボトルネックになっている。 エージェントは書くのが速いが、読み手は追いつけない。 このスキルは、**読み手の頭の中にあるものとの差分だけ**を、検証済みの主張と図で渡す。 ELI5 との違いは 2 つ。 1. 読み手を「5 歳」「マネージャー」のような型でなく、実在の 1 人のペルソナとして持つ。知っていることは書かない。 2. 書いた主張を道具で検査する。「自分で書いていて自信がなくなる」を、検査の緑に置き換える。 読了が 20 分を超える、演習が要る、概念に順序がある。このどれかなら、章立ての `explainer-book` を使う。 ## 準備（初回だけ） スクリプトは、このスキルのディレクトリ（以下 `<skill>`）の `scripts/` にあります。 依存は、資料を置くリポジトリに入れます。Node 24 以上が必要です。 ```sh npm i -D @mizchi/vlmkit marked playwright mermaid ``` D2 の図（`figures/*.d2`）を使うときは `d2` の CLI、データの図（`figures/*.vl.json`）を使うときは `vega` と `vega-lite`、アイコンを使うときは `@iconify-json/lucide` と `@iconify-json/logos` も入れます。 形式手法の例を扱うときは、TLC（Java 11+）や Apalache（Java 17+）、`z3-solver` も入れます。 `verify-doc.mjs` は `$TLA2TOOLS`（tla2tools.jar）と `$APALACHE`（apalache-mc）を、リポジトリの `.tools/` から探します。 ## 手順 ``` 1. ペルソナ リポジトリのルートの personas/<id>.md を読む。無ければ、質問する前に仮のファイルを書く 2. 問いを絞る 読み手が「読み終えたら判定できるようになること」を 1〜3 個、疑問文で書く。伝えたいこと 1 文と、節ごとの役割の表を書く前に作る 3. 差分を決める ペルソナの「知っている」に載っていることは書かない。「怪しい」を本文の芯にする 4. 実物を作る 主張ごとに、実行できる例（コード・モデル・コマンド）を先に作って走らせる 5. 書く references/writing.md の型で。価値を先に、根拠は後に。出力は貼る、打ち直さない。書き終えたら削除テストと「読みやすい日本語」（チャットの返答も） 6. 図 references/figures.md。事実シート（*.facts.json）を先に、図は後 …
Read the whole file at its exact version.
How to install
mdr add mizchi/explainer/explainer@sha256:99e089961affbf6fThe line at the top of this page pins the label git:20261010.c02cca9, 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_oflavjrp4i2pxasg)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 12 versions of this file, between Sep 28, 2026 and Oct 10, 2026, about one every day.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20261010.c02cca9 latest | 2026-10-10 | c02cca9 | 20,107 B | A | view · diff |
| git:20261010.8ccb2e5 | 2026-10-10 | 8ccb2e5 | 19,631 B | A | view · diff |
| git:20261003.743714c | 2026-10-03 | 743714c | 19,710 B | A | view · diff |
| git:20261003.092c173 | 2026-10-03 | 092c173 | 19,158 B | A | view · diff |
| git:20261002.4b14b53 | 2026-10-02 | 4b14b53 | 19,522 B | A | view · diff |
| git:20261002.a9d910c | 2026-10-02 | a9d910c | 18,970 B | A | view · diff |
| git:20261002.960fe1d | 2026-10-02 | 960fe1d | 18,660 B | A | view · diff |
| git:20261001.7565f92 | 2026-10-01 | 7565f92 | 14,598 B | A | view · diff |
| git:20260930.42f53ff | 2026-09-30 | 42f53ff | 14,122 B | A | view · diff |
| git:20260928.72efd42 | 2026-09-28 | 72efd42 | 13,625 B | A | view · diff |
| git:20260928.ed6949d | 2026-09-28 | ed6949d | 12,810 B | A | view · diff |
| git:20260928.563bef8 | 2026-09-28 | 563bef8 | 12,247 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 (20107 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_oflavjrp4i2pxasg GET https://markdownregistry.com/api/v1/resolve?ref=mizchi/explainer/explainer GET https://markdownregistry.com/api/v1/blob/99e089961affbf6f52dcc9ddb78ef4af886c35cb4b1616d350888b72e93778ea
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.
More from mizchi/explainer
Every file in mizchi/explainer