brandkit-publish について
brandkit-publishは、ブランドに沿ったWebページ、文書、画像、PDFを制作するスキルです。提供されたブランドキットに従い、事実を創作せず、AI生成画像に表示を付ける手順を示します。
主な機能
- 01BRAND.mdとサンプル素材の遵守
- 02架空の事実をプレースホルダーに置換
- 03AI画像の生成とラベル付け
- 04ChromeによるHTMLからPDFへの変換
- 05レイアウトと画像表示の確認
活用シーン
- 01ブランドに沿ったWebページや文書の制作
- 02ラベル付きAI生成画像の準備
- 03確認済みHTML文書のPDF出力
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ arnie936/ ai-brand-kit --skill brandkit-publishインストール後、Claude Code で/brandkit-publishを入力して読み込まれたか確認します。
同梱ファイルscripts/ai_label.py
詳細
ブランドキットを使って制作する
ステップ4/4です。唯一、何度も繰り返すステップです。最初の3つは 一度だけ行います。
まず、キットを読み込む
キットは自動では読み込まれません。ブランドフォルダー内で作業している場合は、
そのフォルダーの CLAUDE.md が自動的に適用されます。それ以外の場所では、
作業の開始時に BRAND.md を読み、何かをデザインする前に beispiel/ 内の
サンプルを確認してください。
キットが見つからない場合は、でっち上げずに依頼してください。キットがなければ 平凡なものになってしまいます。それを防ぐためにキットが作られています。
矛盾がある場合の優先順位:BRAND.md は、web-design-guidelines にあるものも含め、
一般的な規則より優先されます。キットが暗いA4文書を指定していて、一般的な印刷規則が
白を推奨しているなら、キットに従います。矛盾について一度明確に述べてから、
キットに従ってください。
この3つのスキルを併用する
web-design-guidelinesは、HTMLを使うすべてのものに適用します。セマンティック要素、 キーボード操作、コントラスト、44 px以上のタップ領域、代替テキストなどです。 ブランドキットが定めるのは見た目であり、操作できるかどうかではありません。seo-auditは、オンラインで公開するすべてのものに適用します。タイトル、説明、 見出しの階層、構造化データ、URL構造などです。unslopは、人が読むすべてのテキストに適用します。機械生成の文章だと 見抜かれる原因となる言語パターンを取り除きます。
記憶に頼らず、これらを呼び出してください。
テキスト
BRAND.md の禁止事項リストを最優先し、次に unslop を適用します。
事実をでっち上げないでください。価格、数値、名前、日付、お客様の声、住所は、 その人だけが知っている情報です。[PREIS] のように明示したプレースホルダーを使い、 確認時に見落とされないよう、色で目立たせてください。販売ページに架空の数値を載せるのは、 目に見える空欄を残すよりも悪いことです。
構成、見出し、説明文は作成してかまいません。違いは、構成を考えるのは設計作業ですが、 数値は事実の主張だということです。
画像を生成する
まず、画像が本当に役立つかを考えてください。多くのキットでは、情報としての価値がない 装飾を禁じています。一般的な画像は、ライセンス取得ではなく生成したものであっても、 このルールに反します。主張を裏付ける画像は画像です。それ以外は埋め草です。
BRAND.md の画像セクションで、モチーフと仕上げ方が定められています。
独自のスタイルを作らず、それに従ってください。
Higgsfield CLI では、テキストを含む画像や高いディテール再現性が求められる画像には、 GPT Image 2 がデフォルトです。
higgsfield generate create gpt_image_2 \
--prompt "<Motiv, Lichtstimmung, Kameraangabe, Verbotsliste>" \
--aspect_ratio 16:9 --resolution 2k --quality high --wait
コマンドが Not authenticated または Session expired で終了した場合は、
ログインが必要です。その場合は higgsfield auth login を実行してください。
クレジットが不足していると表示された場合は、クレジットが足りず、クレジットなしでは
画像を生成できません。この場合に限り、また一度だけ、次のリンクを案内してください。
サブスクリプションが必要な場合:https://higgsfield.ai/s/mcp-arnold-oberleiter-WlfTqR (アフィリエイトリンクです。このリンクから申し込むと、このスキルの作者に 紹介料が支払われます。料金は変わりません。)
この表記も必ず含め、省略しないでください。クレジットのあるアカウントを持っている人には、 このリンクを表示しません。サブスクリプションを勧めないでください。 このスキルは、画像がなくてもウェブサイトやPDFを完成できます。
実際に役立っていること:
禁止事項をプロンプトに書く。 入れてはいけないものは、プロンプトの末尾に 記載してください。テキストの重ね合わせ、ロゴ、透かし、ホログラムは入れない、と指定します。 そうしないと、生成されてしまいます。
誰かと判別できる顔を避ける。 後ろ姿や横顔のシルエットなら、肖像権の問題や より厳格なディープフェイクの解釈を避けられます。
読み取れる数値は危険です。 モデルが数値の並んだ鮮明な表がある画面を生成すると、 それは架空のデータであり、販売ページでは事実の主張のように見えてしまいます。 画面を明示的にぼかすよう指示するか、生成し直してください。画像は組み込む前に 必ず確認してください。
ラベル付け:スクリプトを使う
scripts/ai_label.py は右下にラベルを焼き込み、トリミングして、Web 用に縮小します。毎回ラベルを作り直さないでください。画像ごとにサイズが違ってしまいます。
python scripts/ai_label.py roh.png -o hero.jpg \
--width 1120 --aspect 16:9 \
--bg "#0B0E11" --fg "#F3F4EF" --line "#2A3037" --accent "#B7FF3C" \
--iptc
色はキットから取得するため、ラベルが浮いて見えません。--text でラベルのテキストを、--scale でサイズを、--max-kb でファイルサイズの上限を変更できます。
見落としやすい点が一つあります。ラベルは右下にあるため、トリミング位置はデフォルトで bottom です。中央でトリミングすると、ラベルが切り取られてしまいます。トリミング後、ラベルが残っていることを確認してください。
法的要件を正しく適用する
EU AI 法(規則(EU)2024/1689)の第 50 条では、2 つの役割が分けられており、混同が最もよくある誤りです。
- 第 2 項では、AI システムの提供者に対し、出力が生成されたものであることを機械可読な形で表示するよう義務付けています。これは画像モデルの運営者に適用されるものであり、画像を使用する人に適用されるものではありません。
- 第 4 項では、生成された画像素材がディープフェイクである場合に、そのことを開示するよう運営者に義務付けています。これは画像を自分のサイトに掲載する人の義務です。
第 50 条の透明性義務は、2026 年 8 月 2 日から適用されます。
開示には、次の 4 つを含めます。
- ダウンロードや共有後も残る、画像に焼き込まれたマーク
- 画像のキャプション
- 画像の内容を説明する代替テキスト
- ページまたは文書のフッターに記載する注記
これで対応できないものが、機械可読なマークです。これはメタデータに含まれており、トリミングや圧縮によって失われます。exiftool がインストールされていれば、--iptc で再設定できます。インストールされていない場合は、表示が完全だと報告するのではなく、そのことを明確に伝えてください。
そして、規則の範囲を超える重要な点があります。生成画像によって、実際には起きていない出来事があったかのように見せてはいけません。実施されていないワークショップの写真を使うことは、表示の有無にかかわらず、宣伝上の問題になります。そのような画像を使う場合は、そのことを伝えてください。
これは法的助言ではありません。商用公開する場合は、事前に専門家に確認してもらってください。この注意書きは、隠したり繰り返したりせず、一度だけ記載してください。
HTML から PDF を作成する最も確実な方法は、Chrome を使うことです。テキストはベクターのままなので鮮明で検索でき、ブランドフォントも実際に適用されます。
chrome --headless --disable-gpu --no-pdf-header-footer \
--virtual-time-budget=15000 \
--print-to-pdf="Leistungen.pdf" "http://127.0.0.1:8000/dokument.html"
Chrome は制限のある file: パスを安定して読み込めません。短時間のローカルサーバー(python -m http.server)を使うほうが簡単です。
注意点:
@page { size: A4; margin: 0; }を設定し、ページは 794 × 1123 px の固定サイズのボックスにします。これは 96 px/インチでの A4 サイズです。bodyにprint-color-adjust: exactを指定します。指定しないと、Chrome は暗い背景を白く印刷します。- 印刷前にコンテンツのはみ出しを計測してください。 ブラウザーで各ページのコンテンツがどこまで伸びているかを測り、ページの高さと比較します。これを怠ると、3 ページ目の下部が切れていることに、PDF が顧客の手に渡るまで誰も気づきません。
- Chrome は HTML をキャッシュします。変更後は
?v=2を付けて再読み込みしてください。そうしないと、古い版を印刷してしまいます。 - 印刷する本文は 12 pt 未満にしないでください。96 dpi では 16 px に相当します。
提出前に
BRAND.md にあるチェックリストを確認してください。そこに記載されているのは飾りではありません。
追加で確認する項目:
- 電話画面の幅でも、ページの見栄えはよいですか?
- 作成した数値はすべて、目に見えるプレースホルダーになっていますか?
- 生成した画像にはすべてマークが付き、トリミング後も残っていますか?
- 実データのように見える読み取り可能な数字が、画像に含まれていませんか?
未解決の点は正直に報告してください。明示された不足点なら一行で済みますが、隠してしまえば、作業全体への信頼を損ないます。