使い方ガイドへスキップ
design-html作者 Garry Tan

Design HTML スキル。

UI デザインのための Claude Code と Codex スキル:合意されたデザイン方針から本番品質の HTML/CSS を生成します。

  • Web & UI
  • HTML
garrytan/gstack · design-html/SKILL.mdSKILL.md
--- name: design-html description: Design finalization: generates production-quality Pretext-native HTML/CSS. (gstack) --- ## When to invoke this skill ## Confusion Protocol ## Claimed Limitations Need Evidence ## Continuous Checkpoint Mode ## Context Health (soft directive) ## Question Tuning (skip entirely if QUESTION_TUNING: false)
2026-09-14 にアップストリームファイルから読み取ったフロントマターとセクション見出し · 全54,976文字

01 できること

Claude CodeとCodexにおけるdesign-htmlスキルの機能

概要、ワークフロー、出力。いずれもスキルの SKILL.md から読み取った内容です。

SKILL.md より2026年9月14日読取 · 実行記録ではありません

スキル自身の言葉で

Pretextネイティブのテキストレイアウトを備えた本番品質のHTML/CSSを生成します。テキストは実際にリフローし、高さは動的に計算され、レイアウトはリサイズに応じて適応します。承認済みのモックアップ(/design-shotgun)、CEOプラン(/plan-ceo-review)、デザインレビューのコンテキスト、またはユーザーの説明から作業を行います。デザインの複雑さに応じて適切なPretext APIのティアにルーティングされます(シンプルなレイアウトではprepare + layoutを使用、チャットUIではprepareWithSegments + walkLineRangesを使用、エディトリアルスプレッドではlayoutNextLineを使用してテキストが障害物を回避します)。

30KBのオーバーヘッド、依存関係なし。自己完結型のHTMLファイル(Pretextをインライン化してベンダリング)またはフレームワークコンポーネント(React/Svelte/Vue)を生成します。デフォルトはバニラHTMLで、ブラウザで即座にプレビューできるライブリロードサーバーを備えています。lorem ipsumは決して使用せず、モックアップから実際のコンテンツを抽出するか、プランから現実的なテキストを生成します。

生成されるもの

  • Pretextをインライン化してベンダリングした自己完結型のHTMLファイルで、トークンから生成されたCSSカスタムプロパティ、セマンティックなHTML5、ライブ編集用のcontenteditable + MutationObserver、リサイズ時の再レイアウト用のResizeObserverを備え、~/.gstack/projects/$SLUG/designs/<screen-name>-YYYYMMDD/finalized.htmlに保存されます
  • プロジェクトの依存関係に追加されたPretextのimportを含むフレームワークコンポーネントファイル(React TSX/JSX、Svelte、Vue)で、~/.gstack/projects/$SLUG/designs/<screen-name>-YYYYMMDD/finalized.[tsx|svelte|vue]に保存されます
  • HTMLと並んで、source_mockupパス、source_planパス、モード(approved-mockup/plan-driven/freeform/evolve)、pretext_tier、フレームワークの選択、イテレーション回数、日付、画面名、ブランチを含むfinalized.jsonのメタデータです
  • ユーザーが抽出の提案を受け入れた場合、生成されたHTMLから抽出されたCSSカスタムプロパティ、フォントファミリー、カラーパレット、スペーシングスケール、ボーダーラディウス、シャドウ値を含む、オープンなDESIGN.md形式のDESIGN.mdファイルです
プロンプト例を見る ↗

仕組み

  1. 01
    デザインコンテキストを検出してルーティング

    /design-shotgunによるapproved.json、CEOプラン、デザインバリアント、またはDESIGN.mdトークンの有無を確認します。

  2. 02
    実装仕様を抽出

    デザインバイナリが利用可能な場合、承認済みPNGに対してpromptコマンドを実行し、GPT-4o visionで色、タイポグラフィ、レイアウト構造を抽出します。

  3. 03
    Pretext APIのスマートルーティング

    デザインをティアに分類します:シンプルなレイアウトはprepare + layoutでリサイズ対応の高さを計算し、カードグリッドは同様の手法で自己サイズ調整を行い、チャットUIはprepareWithSegments + walkLineRangesでバブルをぴったりフィットさせ、エディトリアルスプレッドはlayoutNextLineで障害物の周りにテキストを配置します。

  4. 04
    PretextネイティブのHTMLを生成

    Pretextをベンダリングしてインライン化した(またはCDNフォールバック付きの)単一ファイルを、トークンからのCSSカスタムプロパティ、セマンティックHTML5、ライブ編集用のcontenteditable + MutationObserver、リサイズ時の再レイアウト用のResizeObserverとともに、モックアップまたはプランから抽出した実コンテンツで書き出します。

  5. 05
    プレビュー前にスロップゲートスキャンを実施

    デザイン検出器が利用可能な場合、完成したページを一度スキャンし、AIスロップパターン(紫のグラデーション、同一のカードグリッド、モックアップに存在しない汎用的なCTA)を検出します。

02 適合性を確認

design-html スキルを使用するタイミング

UI デザインがこの種類の作業の場合、Claude Code または Codex で design-html スキルを使用します。適合性と制限は、スキル自身のファイルから取得されています。

適している場合

  • ダッシュボード、リスト表示ページ、またはカードグリッドを作成し、カードがハードコードされた高さなしでコンテンツに応じて自己サイズ調整する必要がある場合
  • チャットまたはメッセージングUIを実装し、バブルがテキストにぴったりフィットして最小幅を正しく計算する必要がある場合
  • /design-shotgunで承認されたモックアップ、/plan-ceo-reviewのプロダクト戦略、または/plan-design-reviewのコンテキストが存在する状態でデザインを仕上げる場合
  • エディトリアルスプレッド、ブログレイアウト、またはコンテンツ量の多いページを構築し、テキストが障害物や画像の周りに動的に流れる必要がある場合

境界を知る

  • プレースホルダーコンテンツやlorem ipsumを必要とするプロジェクト—このスキルは常にモックアップ、プラン、またはユーザーの説明から抽出した実コンテンツを生成します
  • 人によるレビューなしの自動実行—デザイン検出器のインストール提案やリファインメントループには、AskUserQuestionによるユーザーの判断が必要です

提供すべきもの

  • 承認済みデザインモックアップPNGapproved.jsonに保存された/design-shotgunからの承認済みバリアントへのパス、またはユーザーが指定したPNGパス。
  • CEOプランまたはデザインレビューノートプロダクトビジョン、UI要件、ユーザーフロー、対象ユーザー、ビジュアルの雰囲気、コンテンツ構造を含む、/plan-ceo-reviewまたは/plan-design-reviewからのMarkdownファイル。
  • DESIGN.mdトークンブランドカラー、フォントファミリー、スペーシングスケール、ボーダーラジウス、シャドウ値を含むリポジトリのデザインシステムファイル。
  • フリーフォームモード用のユーザー説明モックアップやプランが存在しない場合、ユーザーが目的/対象ユーザー、ビジュアルの雰囅気(ダーク/ライト、playful/serious、dense/spacious)、コンテンツ構造、参考サイトを提供します。
  • evolveモード用の以前のfinalized.html前回のセッションからの既存の完成済みHTML。

03 スキルの内部

design-htmlスキルがClaude CodeとCodexに与えるルール

SKILL.md がエージェントに設定する6つの具体的な指示、デフォルト、制限 — ファイルの中でも結果を変える部分です。

  1. テキストレイアウトには常にPretextを使用する

    デザインが単純に見えても、Pretextはリサイズ時の正しい高さの計算を保証します。オーバーヘッドは30KBです。すべてのページがその恩恵を受けます。

  2. 実在するコンテンツのみを使用し、プレースホルダーテキストは使用しない

    モックアップが存在する場合は、そこからテキストを抽出します。plan駆動モードでは、プランの内容を使用します。フリーフォームモードでは、ユーザーの説明に基づいて現実的なコンテンツを生成します。

  3. コードの美しさよりも、Source of Truthへの忠実性を優先する

    承認済みのモックアップが存在する場合は、ピクセル単位で一致させます。そのためにCSS gridクラスの代わりに width: 312px が必要であれば、それが正しい対応です。

  4. リファインメントループでは外科的な編集を行い、再生成しない

    ファイル全体を再生成するWriteツールではなく、対象を絞った変更を行うEditツールを使用します。ユーザーがcontenteditableを介して手動で行った編集は保持する必要があります。

  5. 1回の呼び出しにつき1ページ

    複数ページのデザインでは、ページごとに /design-html を1回実行します。1回の実行で1つのHTMLファイルが生成されます。

  6. AIスロップ・ブラックリストをデフォルトで適用

    承認済みのモックアップに含まれている、DESIGN.mdで許可されている、またはユーザーがトレードオフを明示した上で明示的に要求した場合を除き、紫/青のグラデーション、クリーム色とセリフ体の配色、グラデーションテキスト、汎用的な3カラムの機能グリッド、同一デザインのカードグリッド、全て中央揃えのレイアウト、見出しの上のキッカー、ヒーローのメトリクス行、装飾的なブロブ、光るエッジ、ストックフォトのプレースホルダー、汎用的なCTA、ドロップシャドウ付きの角丸カード、絵文字装飾、汎用的な推薦文、判で押したような分割ヒーローは含めません。

04 実際に使う

Claude Code または Codex に design-html をインストール

npx skills add コマンドを実行し、エージェントで最初のタスクを実行して、結果をチェックリストで確認します。

Claude Code、Codex、またはあなたのエージェントに design-html を追加

プロジェクトで実行してください。インストーラーが、どのエージェントに追加するかを尋ねます。

Terminal
npx skills add https://github.com/garrytan/gstack --skill design-html

design-html/SKILL.md用の汎用的なskills CLIフォーム。リポジトリごとに独自のパスが定義されている場合があります。

スキルに最初の UI デザインタスクを与える

スキル自身の用語で記述されています。角括弧の部分はご自身の内容に置き換えてください。

Starter prompt
Finalize the design for our [product name] landing page. I have an approved mockup from /design-shotgun at [path to approved.json]. The page needs a hero section with dynamic text that reflows on resize, a 3-card feature grid where cards self-size based on content, and a pricing table. Use our brand colors from DESIGN.md and make sure all text is editable in the browser so I can tweak copy live. Output as vanilla HTML first so I can preview immediately, then I'll ask for a React component version once the design is locked.

出典:SKILL.md をスキル自身の用語に沿って記述。

最初の結果を確認

SKILL.md 自体が正しい結果として示しているもの:

  • ライブリロードサーバーが http://localhost:PORT/finalized.html で起動しました。ユーザーはウィンドウをリサイズしてテキストが動的に再フローすることを確認したり、任意のテキストをクリックしてcontenteditableのレイアウトが即座に再計算されることを確認できます
  • 承認済みのモックアップPNGが存在する場合、リファインメントループ中の視覚的比較のためにインラインで表示されます。存在しない場合は、plan駆動モードまたはフリーフォームモードにおいて、ループ中のユーザーフィードバックがSource of Truthとなります
  • Pretextレイアウト計算のためにテキストメトリクスが正確であることを保証するため、最初のprepare()呼び出しの前にdocument.fonts.readyによるフォント読み込み完了の確認ゲートを設けます
  • ユーザーがリサイズ動作とライブテキスト編集をテストした後、リファインメントループ内で「done」「ship it」「looks good」「perfect」のいずれかを確認します。最大10回のイテレーション後、続行するかdoneを呼ぶかを提案します

OpenDesignではSKILL.mdのリンクからdesign-htmlをインポートします:Plugins → Add → Skill → Import from link。その後、トップバーで選択します。

05 オープンソースで追跡可能

ソース、ライセンス、検証

このページの情報の出所と、最終確認日時です。

Author
Garry Tan
Repository
github.com/garrytan/gstack ブランチ main
スキルファイル
design-html/SKILL.md 検証時に記録されたコンテンツチェックサム、コミット 71f6048
License
MIT LICENSE より。
リポジトリスター数
132,921 GitHub スナップショットは 2026-09-14 に garrytan/gstack リポジトリ全体を対象に取得されました。このリポジトリにはこのカタログ内の 7 つのスキルが含まれています。design-html の評価や使用回数ではありません。
OpenDesign により検証済み
2026-09-14 ソースファイル、パス、ライセンステキスト、スター数を確認済み。OpenDesign 本体にはバンドルされていません(2026-08-28 確認)。このページには実行記録がありません。

SKILL.md の中身

  1. このスキルを呼び出すタイミング承認済みのモックアップ、CEOのプラン、デザインレビューの文脈、またはユーザーの説明を基に、本番用のHTML/CSSを作成する場合に使用します
  2. プリアンブル(最初に実行)gstack-skill-startを実行し、STATUS行を読み取り、劣化モードを処理し、オンボーディング/同意のためのGSTACK_INSTRUCTIONブロックに従います
  3. プランモードでの安全な操作プランモードで許可される操作:codex exec/review、~/.gstack/への書き込み、プランファイル、成果物のためのopen
  4. プランモード中のスキル呼び出しスキルの指示は参照ではなく実行可能なものです。AskUserQuestionはターン終了の要件を満たします。ExitPlanModeはワークフロー完了後にのみ使用します
  5. AskUserQuestionのフォーマットツールの解決はSESSION_KINDに応じて分岐します。spawnedは推奨されるものを自動選択し、Conductorはプロース形式を使用します。失敗時のフォールバック処理も含みます
  6. 成果物の同期(スキル開始時)skill-startの出力に基づいて動作します:GBrainヒント、ARTIFACTS_SYNCのヘルスチェック、GSTACK_INSTRUCTIONを介した一度限りのプライバシー同意ゲート
  7. モデル固有の動作パッチ(claude)Todoリストの規律、重要な操作の前に考えること、Bashよりも専用ツールを優先すること—これらの好みはスキルの指示に従属します
  8. ボイスGStackのボイス:要点から始め、具体的な詳細を示し、選択をユーザーの成果に結びつけ、品質について率直に述べ、締めは範囲を限定します
  9. コンテキストの復元直近の成果物、レビュー、タイムライン、決定事項、最新のチェックポイントを復元し、RECENT_PATTERN が示唆する場合は次のスキルを提案します
  10. ライティングスタイル専門用語は初出時に簡潔に説明し、質問は成果を軸に構成し、短い文で能動態を使用します。EXPLAIN_LEVEL: terse の場合はスキップします
  11. 網羅性の原則 — Boil the OceanAI によって網羅性のコストは低くなるため、フルカバレッジを推奨します。選択肢間でカバレッジが異なる場合は Completeness: X/10 を示します
  12. 混乱プロトコル重大な曖昧さがある場合は一旦停止し、その旨を明示し、トレードオフを伴う2〜3の選択肢を提示して確認します。日常的なコーディングでは適用しません
スキル自身による説明
「デザインの確定:本番環境向けの Pretext ネイティブ HTML/CSS を生成します。(gstack)」

SKILL.md のフロントマター説明。完全なファイルは約 54,976 文字です。GitHub で完全なファイルを読む。

06 インストールする前に

design-html スキルに関する質問

回答は 2026-09-14 時点で読んだ SKILL.md に基づくもので、記録された実行結果によるものではありません。

これは React/Svelte/Vue プロジェクトでも使えますか、それとも vanilla HTML 専用ですか?

どちらでも使えます。ステップ 2.5 で package.json からフレームワークを検出し、vanilla HTML(自己完結型のプレビューファイル、初回パスに推奨)にするか、Pretext フックを備えたフレームワークネイティブのコンポーネントにするかを確認します。フレームワークが検出されない場合は vanilla がデフォルトです。フレームワーク出力の場合は TypeScript か JavaScript を選択できます。

Design HTML

実際の UI デザインタスクで design-html を実行します。

OpenDesign をダウンロードし、SKILL.md リンクから design-html をインポートし、上記のプロンプトを貼り付けて、結果の前に計画を確認します。

ターミナル
npx skills add https://github.com/garrytan/gstack --skill design-html

OpenDesign デスクトップ版

ひとつのデザインシステムで、すべての制作物をブランドらしく

完全な Vibe Design Workspace で、同じブランドルールを Web サイト、スライド、操作できるプロトタイプ、ダッシュボード、画像、HTML 動画に展開できます。ローカルの Codex、Claude Code、Cursor などを接続して無料で制作しましょう。

  • Web、スライド、プロトタイプ、ダッシュボード、画像、動画
  • 140+ のデザインシステムと完全なテンプレート/スキルライブラリ
  • ローカル Codex と 21+ のコーディングエージェントを接続 · 無料
無料ダウンロード

macOS と Windows に対応