explain-html plugin
explain-html Skillと、Archifyによる図の完了検査を呼ぶClaude Code用Stop hookをまとめたpluginです。解説HTMLに掲載する図について、モデル・配布HTML・標準SVG・記事画像の一致を検査します。
渡す情報
解説したい題材と保存先を用意します。完成検査の対象には、図の担当・成果物を記録したmanifestと記事HTMLが必要です。配布物の生成にはPython 3、検査にはSkill正本に記載されたPython・Node.jsの実行環境を使います。Codex用hook adapterは未提供です。
依頼例
explain-htmlで、HTTPリクエストがサーバーに届くまでの仕組みを解説してください。
通信の流れを図で示し、完成時に図と記事の検査結果を確認したいです。
進め方
- 導入を始めるの手順でClaude Code用配布物を生成し、Agentでの読み込みを確認します。
- 題材を伝え、Skillの手順で記事と図を制作します。
- 対象プロジェクトの
.explain-html-active.jsonに、manifestと記事HTMLの相対パスを指定します。具体例はArchifyゲートの正本を参照します。未紐付けのプロジェクトにはhookは介入しません。 - 完成時は生成CLIの検査とStop hookの結果を確認します。Claude Codeには連続blockの上限があるため、hookと生成CLIを併用します。
成果物の例
サブエージェントが正本のビルド処理からClaude Code用ZIPを生成しました。ZIPを展開し、manifest・hooks設定とSkillの全ファイルが正本と一致することを検証しています。
この例は配布物の生成と内容検証までです。インストール・有効化・実クライアント上のStop hook動作は未実施です。解説HTML自身の例はSkillガイドを参照してください。
確認するポイント
- Claude Code用の配布物を選んでいるか。
- 対象プロジェクトと、検査するmanifest・記事HTMLの紐付けが正しいか。
- 図の一致検査と、文章や図の意味・読みやすさの確認を区別しているか。
- CLIによる完成検査に加え、利用環境でStop hookが呼ばれることを確認したか。
正本を読む
plugin定義・ビルド処理とSkill正本で管理します。共通の配置方針は配布・導入ガイドを参照してください。