Claude CodeやCodexに「HTMLで出して」と頼むと、それなりのページは返ってきます。ただ、ワイヤーフレームを頼んだのに完成品風のカードが並んだり、動作確認を頼んだのに押せない静止画が返ったりと、粒度のブレが起きます。plannotator/effective-html は、その「どの完成度で出すか」をスキル側に持たせて分業させるスキル集です。ライセンスはMIT、2026年10月30日時点の収録は7本、GitHubのスター表示は約3.8k、最終コミットは2026-10-15です。

公式READMEのデモ。html-diagram が出した単一HTMLの図で、上部のピルを押すと該当経路だけが浮かび上がる。出典: plannotator/effective-html README

30秒でわかる effective-html

  • ・Claude Code / Codex / Cursor 等に入れるHTML成果物スキル7本(MIT)。ワイヤーフレーム・モックアップ・動くプロトタイプ・計画書・図を、ビルド不要の単一HTMLで出させる
  • ・Codexの設定で暗黙起動を許すのは7本中2本だけ(html と design-artifact)。Claude Codeはdescriptionの文言から読む(実起動は未検証)
  • ・ワイヤーフレームはわざと未完成のまま出す。構造の違う2〜3方向を1ファイルで比較する
  • ・description 7本ぶんは約2,550バイト。全展開で47,274バイト

Claude Code本体の設定やHooks・CLAUDE.mdまで含めた全体像は Claude Code|2026年版・インストールからCLAUDE.md・Hooks・本番運用までの実装手引き にまとめてあります。本稿はその拡張側、HTMLを成果物として出させる部分だけを扱います。

effective-htmlとは|Claude Code・Codexに入るHTMLスキル集7本

解こうとしているのは「HTMLを書かせること」ではなく、どの完成度で止めるかのブレです。構造を議論したいのに配色まで決まったページが来ると、論点が「この青でいいのか」にすり替わります。逆に動作を確かめたいのに静止画風のモックアップが来ると、押せないボタンの前で会話が止まります。

WHAT IT REPLACES何を代替するか

HTML成果物の完成度のブレを、スキルの分担で抑える

「HTMLで出して」だけ

完成度はモデル任せ

  • ワイヤーフレームのつもりが完成品風
  • 動作確認のつもりが静止画風

effective-html(7本)

粒度ごとにスキルを分ける

  • html が依頼を振り分ける
  • wireframe は未完成のまま出す
  • prototype は状態まで動かす
出典: plannotator/effective-html README と各 SKILL.md(2026-10-30時点)

7本は、それぞれが持つレビュー質問で分かれています。html が振り分け役です。

スキル 持ち主となる問い SKILL.md
html どれに振るか。該当なしのレポート・解説・LP・ツール 6,548 B
design-artifact 配色・書体・構図をどう決めるか 10,948 B
html-wireframe 何を載せ、どう並べ、どう遷移させるか 4,859 B
html-prototype 触ったとき入力・状態変化・失敗復帰はどう動くか 6,055 B
html-plan 元資料の約束事を保ち、順序・担当・依存をどう見せるか 2,456 B
html-diagram 関係・順序・状態のどれを、どの記法で描くか 2,709 B
big-pics-little-words 大きな図と少ない言葉で今の話題を説明する 575 B

7本目の big-pics-little-words は2026年10月15日の追加です。READMEによれば別リポジトリ bro からのコピーで、SKILL.md は短い指示文だけです。

読者の3問に答えると次のとおりです。

・何ができるか ビルドもCDNも要らない.htmlを1枚出させる。ブラウザで開けば動き、Slackに投げても再現する
・何を解決するか 粒度のブレ。ワイヤーフレームなら意図的に粗い成果物、プロトタイプなら読み込み中・エラー・成功まで含む動く画面が返る
・何を代替するか 初期段階の構造検討(Figma・パワポ・手書き)とREADME用の図。本番のコンポーネント実装は代替しない。SKILL.md自身が独立HTMLが成果物でない通常のアプリ実装には使うなと書いている

「なぜMarkdownでなくHTMLか」は Claude CodeはなぜMarkdownでなくHTMLを出力すべきか|情報密度と共有性の優位を9ユースケースで解説 で扱っています。READMEはこのエッセイ(Thariq Shihipar氏)を着想元に挙げています。

effective-htmlのインストールと使い方|npx skills・Claude Code・Codexの3経路と暗黙起動

導入経路は、READMEに載っている3つです。

# 汎用(Claude Code / Cursor / Cline など)
npx skills add plannotator/effective-html
# 中身を見て選ぶ
npx skills add plannotator/effective-html --list
npx skills add plannotator/effective-html --skill html-wireframe

Claude Codeのプラグインなら /plugin marketplace add plannotator/effective-html のあと /plugin install plannotator-effective-html@effective-html、Codexなら codex plugin marketplace add plannotator/effective-html と codex plugin add plannotator-effective-html@effective-html です。

2026年8月25日(6本の時点)に空のディレクトリで npx skills add を実行して確認した結果です。2026年10月の7本版は --list の本数とリポジトリ現物の突き合わせまでで、再インストールは未検証です。

・実体は ./.agents/skills/<スキル名>/ に置かれ、17種のエージェント共通の場所として扱われる
・Claude Code向けには ./.claude/skills/<スキル名> から実体へのシンボリックリンクが張られる
・置かれたのは18ファイル・合計49,744バイト。skills-lock.json に各スキルの computedHash(SHA-256)が残る
・完了時に「使う前にレビューを。スキルはエージェントの全権限で動く」という警告が出る

INSTALL PATH導入の流れ

実体は1か所、Claude Codeにはリンクで届く

  1. npx skills add

    plannotator/effective-html を指定

  2. .agents/skills/ に実体

    17種のエージェント共通の置き場

  3. .claude/skills/ にリンク

    シンボリックリンクで二重化しない

  4. skills-lock.json

    スキルごとの SHA-256 を記録

出典: 2026-08-25に6本の時点で npx skills add を実行して実測(18ファイル・49,744 B)

SKILL.mdはエージェントへの指示文そのものです。入れる前に目を通す価値があります。

暗黙起動の設定は7本中2本だけ|Codexの設定とClaude Codeの止め方

スキルはdescriptionが読まれるため、意図しない発火はコンテキストと成果物の両方を汚します。仕組みは Claude Skillsとは|「スキル=フォルダ」の仕組みと作り方・使い方を徹底解説 が詳しいです。effective-htmlは各スキルに agents/openai.yaml(Codex向け)を同梱しており、2026年10月30日に全7本の allow_implicit_invocation を確認しました。

スキル allow_implicit_invocation descriptionの独立発火禁止文
html true なし(ルーター)
design-artifact true なし
html-wireframe / html-prototype / html-plan / html-diagram false あり
big-pics-little-words false なし(frontmatterで disable-model-invocation: true)

html はルーターなのでtrueは設計どおりです。注目は design-artifact で、「あらゆる視覚的HTML成果物を作る・作り直すとき」と広く取っており、禁止文もないため、Codexでも名前を呼ばずに動く2本目になります。Claude Codeのスキルはfrontmatterとdescriptionで読まれ、openai.yaml は本稿では参照していません(Claude Code側の仕様は未確認)。Claude Codeで同じ結果になるかは未検証です。

見た目を勝手に決められたくないとき

--skill で必要な分だけ入れます。npx skills add plannotator/effective-html --skill html-wireframe のように個別指定でき、design-artifact を外せます。

止め方には経緯があります。2026-06-09のコミット bafaaec で html-diagram と html-plan のfrontmatterに disable-model-invocation: true が付き(html にも付いていました)、2026-07-29のPR #9(dd55f31)でwireframe・prototypeの追加と同時に、この3本から削除されました。以後はdescriptionの散文が代わりです。そのため html はルーターとしてCodexでtrueになっています。現在は6本のfrontmatterが name と description のみで、frontmatterのキーが無い以上、Claude Code側で暗黙起動を止めているのはdescriptionの文言だけと読めます。2026-10-15追加の big-pics-little-words だけが、このキーを再び持ちます。

html-wireframe・html-prototype・html-planの使い方|未完成で出す/状態まで動かす/計画書にする

html-wireframe の要求は明快で、完成品に見えてはいけません。グレースケール、システムフォント、素の枠線のみで、ブランドカラー・グラデーション・影・装飾画像は禁止です。構造が未確定なら、ナビゲーション・グルーピング・主要アクションの位置・情報密度が違う2〜3方向を作れと指示します。色違いや並べ替えは別方向と認めません。

html-wireframe が1つのHTMLに出した3方向のワイヤーフレーム比較
公式サンプル examples/release-readiness/wireframe.html の3方向(Decision first / Evidence ledger / Guided gate)。出典: plannotator/effective-html examples

3方向は同じ内容・同じタスクで構造だけが違い、議論を色の話に逃がしません。Figmaの操作手順ではなく、構造の選択肢を並べて捨てる工程をエージェントに肩代わりさせる使い方です。

html-prototype にはモックアップ(視覚が論点)とプロトタイプ(挙動が論点)の2モードがあります。同梱の states.md は、押せるボタンが並ぶだけで終わらないよう状態を表にしています。

状態 引き金 取れるアクション
Blocked iOSスモークテスト失敗 再実行を記録
Saving 再実行を送信 待つ(フォーム無効化)
Save error 疑似サービスが拒否 再試行 / キャンセル
Ready 4項目すべて通過 本番リリースを要求
Release requested 有効化された操作を選択 説明を閉じる

最後の状態が設計思想を表します。押せるが実際にはデプロイせず、ここから先は本物のシステムが引き取る境界を明示します。SKILL.mdも、死んだボタンは消し、実システムのアクションは完了したふりをせず境界を説明せよと書いています。

公式サンプル2ファイル(8月25日解析)は、外部ホストへの src / href が0件、fetch / XMLHttpRequest / WebSocket も0件で、書体はOS常駐のスタックのみ。ネットワークを一切踏まないファイルです。

html-plan skillとhtml-diagramの使い方

html-plan は、計画書・ロードマップ・実装手順を、元資料の範囲・順序・約束事を保ったままHTMLにするスキルです。SKILL.mdの規則は次のとおりです。

・根拠のないタイムライン・進捗率・ステータスバッジ・ダッシュボード要約は足さない
・決定済みの事項と、仮定・未解決の問いを分ける
・順序と依存は実在するものだけ見せる。厳密な対応は表で出す
・完成後は広い幅と狭い幅で確認し、約束事が消えていないか、段階の順序が保たれているかを見る

html-plan のdescriptionには「Do not activate independently」とあります。この文言からは、html-plan と名前を挙げて頼むか、html スキルから振られる使い方が想定されていると読めます(実起動は未検証)。

html-diagram は関係・順序・トポロジ・状態・階層から、問いに合う記法を選びます。何でも同じ箱と矢印にしないのが方針です。どちらも成果物は絶対パスで返し、構造上の解釈を足した場合は申告させます。

design-artifactの出自とコンテキスト消費|導入前チェック

design-artifact(10,948バイト)は、何を作るかでなくどう感じさせるかを決めます。今のAI出力が着がちな衣装として、クリームにセリフ体とテラコッタ、黒地にアシッドグリーン、白地の紫→青グラデーション、無難さで選ばれたInter、全部中央揃えなどを列挙して禁じます。同系統の発想は Hallmark デザインスキル解説|AI slopを拒みClaude Code・Cursorで使う にもあります。

出自の記述は短期間で変わっています。

・2026-08-03(1913a32) Anthropic公式の web-artifacts-builder から派生と追記
・同日(89ed09a) Claude Code内蔵のガイダンスに着想を得たへ書き換え。リンク可能な上流SKILL.mdは存在しないとした

design-artifactとAnthropic公式web-artifacts-builderのSKILL.md実測比較

8月25日に anthropics/skills の web-artifacts-builder/SKILL.md(3,087バイト、React+Vite+Tailwind+shadcnのビルド手順が主体)と比べると、特徴的なフレーズ10個の逐語一致は0件でした。design-artifact は公式スキルの移植ではなく、Plannotatorが書き下ろした別物と読むのが実態に合います。

入れる前に知っておくこと

design-artifact は完成後、公開ページとして共有するかユーザーに尋ねろと指示し、同意が得られた場合だけ tot CLI(@plannotator/tot)で公開します。同意なしの公開は禁止する文言もありますが、未公開UIについて「共有しますか?」と聞かれうる点は把握しておくとよいです。

コンテキスト消費は、2026年10月30日にリポジトリ現物の7本で計測し直しました。

CONTEXT COSTコンテキスト消費

常時読まれるのはdescription だけの段階開示

2,550B

常時ロード

7本の description 合計。Claude Code では big-pics を除く2,449 B

47,274B

全展開

SKILL.md 7本 34,150 B + references 5本 13,124 B

18.5倍

全展開 ÷ 常時

47,274 ÷ 2,550

出典: plannotator/effective-html の SKILL.md を実測(2026-10-30時点)。big-pics-little-words は disable-model-invocation: true

常時読まれるのは7本のdescription合計2,550バイトだけです(Claude Codeでは big-pics-little-words を除く2,449バイト)。起動すると SKILL.md 本体(7本合計34,150バイト)、html が必要と判断すると references/ の5本(13,124バイト)が加わります。1本あたりでは design-artifact が337バイトのdescriptionで約10.6KBの本体を引き当てるため、暗黙起動を許す設定の1本でもあり、意図せず発火したときの影響が最大です。

導入前の確認点は3つです。

・入れるスキルは --skill <name> で選べる。見た目を勝手に決められたくないなら design-artifact を外す
・同梱の validation.md は「5スキル」の時点の記録で、現物より古い
・成果物はレビュー用の使い捨てで、本番実装は範囲外

最初の1本は html-wireframe だけを入れ、手元の企画を3方向で頼むのが入り口です。議論が配色でなく構造から始まったかで、チームに効くかを1回で判断できます。

参照ソース