explainer
特定の読み手に向けて、概念・PR・設計を「冗長にならない水準」の速習資料として説明し、図と主張を道具で検証する。読み手のペルソナ(既に知っていること・知らないこと・読み方)を質問と公開情報から作り、その差分だけを書く。図は vlmkit-anim で事実シートに照らして描き、本文に引用するコード・出力は再実行して照合し、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 (a reviewer, an on-call engineer, a teammate) is given. Also when the user wrote an explanation themselves and lost confidence in it.
Pinned to revision 4d7f92a090c2, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/explainer/SKILL.md
- skills/explainer/references/figures.md
- skills/explainer/references/persona.md
- skills/explainer/references/writing.md
- skills/explainer/scripts/build-html.mjs
- skills/explainer/scripts/figure-arrows.mjs
- skills/explainer/scripts/figure-check.mjs
- skills/explainer/scripts/figure-variants.mjs
- skills/explainer/scripts/icons.mjs
- skills/explainer/scripts/tlc-to-scene.mjs
- skills/explainer/scripts/verify-doc.mjs
Every link opens the file at its source, pinned to the revision this page describes.