Communitygithub.com

manual-de-marca

ロゴのSVGと承認済みのブランディング提案から、スライド形式のブランドブック(マニュアル・デ・マルカ)を作成します。ロゴのバリエーション、グリッド、プロテクションエリア、最小サイズ、CMYK/Pantoneカラー、ライセンス情報、ロゴのZIPファイルを提供します。

manual-de-marca とは?

このスキルは、SVGロゴと承認済みのブランディング提案(Googleスライド、PPTX、PDF)を入力として、プロフェッショナルなブランドブック(マニュアル・デ・マルカ)を生成します。Claude CodeなどのAIエージェント向けに設計されており、ユーザーに1つずつ質問を行い、常に推奨事項とその理由を提示します。各決定はクライアントに説明できる形で文書化されます。スキルは、SVG解析、ロゴバリエーション(カラー、リコンポジション、ロックアップ)、カラーシステム(CMYK変換、Pantone近似、コントラストマトリックス)の生成、タイポグラフィライセンスの検証、スライドデッキの構築、配信用のファイルパッケージ化など、スクリプトとリファレンスガイドによってサポートされる明確な9フェーズのワークフローに従います。本番スライドはGoogle Slides API(Slidesタイプ)を使用してレンダリングされ、カスタムフォントと戦略的テキストを含みます。ペースは遅く意図的であり、すべての文書化された決定が測定可能かつ検証可能であることを保証し、クライアント、チーム、サプライヤーに対してブランドの一貫性を維持します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/albdanyb22/skills-branding/tree/HEAD/manual-de-marca

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

マニュアル・デ・マルカ(ブランドブック)

決定済みのアイデンティティ(ロゴ+戦略)を規範的なマニュアルに変換します。 この文書は、クライアント、そのチーム、サプライヤーに対し、デザイナーがいなくても ブランドを正しく使用する方法を伝えます。マニュアルは決定を文書化し、勝手に決定を下すことはありません。 そのため、このスキルは多くを質問し、承認なしにはほとんど生成しません。 マニュアルに記載されるすべてのことは、クライアントに対して説明可能でなければなりません。

スキル全体のリズム: 常に1つの質問、推奨事項とその理由を1行で提示します。 相手が議論なしに受け入れた場合、その意味(コスト)を1文で述べてから先に進みます。 進行状況を声に出して数えます(「ブロック3/6 — カラー」)。 何かを見て調べられるもの(PPT、SVG、ライセンスのWebサイトなど)は、質問する代わりに調べてください。

ツール

このスキルは、scripts/ および references/ ディレクトリにある独自のスクリプトとガイドを使用します。 スクリプトは Python と Playwright/Chromium、Pillow、numpy、scipy を使用します。 text_to_svg.py はさらに uharfbuzz が必要です(pip install --break-system-packages uharfbuzz)。 すべて -h を受け付けます。ガイド:

  • references/entrevista.md: 順序付けられた質問バンク。デフォルトの推奨事項付き。
  • references/nucleo.md: 基本マニュアルのページ。
  • references/modulos.md: 拡張モジュール(FIFA World Cup 26 の公開マニュアルを参考にしています)。
  • references/esqueleto-slides.md: 固定の編集テンプレートとデッキの技術的構築。

可視のタスクリスト(分析、インタビュー、バリエーション、コンストラクティブ、 カラー、デッキ、パッケージ)を保持します。作業は長く、ユーザーが離れたり戻ったりする可能性があります。

フェーズ0 — 必須入力

不足しているものを1つのメッセージでリクエストします:

  1. ロゴのSVG。テキストはアウトライン化されていること。PNG/JPGのみの場合は停止: SVGがなければ、測定も信頼できるバージョン生成もできません。他のSVG(他のバージョン、コンストラクティブグリッド)もリクエストします。
  2. 以前のブランディング提案: Google スライド(propuesta-branding が生成したもの)、.pptx、またはPDF。存在しない場合は停止し、propuesta-branding の実行を提案します。マニュアルは戦略を発明しません。

プレゼンテーションを読み込みます(.pptx の場合は python -m markitdown または python-pptx を使用し、ビジュアルアイデンティティページの画像も抽出して確認します。そこには通常、ロゴシステム、適用パレット、ピースがあります)。次のようなカードを作成します: 私たちは何者か、ミッション、ビジョン、価値観、パーソナリティ、トーン(言うこと/避けること)、ポジショニング、マントラ、ロゴコンセプト、ムードボード、タイプボード、パレット、タイポグラフィ、そして暗黙のルール(例:「名前は常に黒、プレフィックスは色が変わる」)。マニュアルに必要なフィールドが欠けている場合は、そのフィールドだけ質問します。読み取り可能なHEXなしで色が現れた場合は、画像からそれを表示し、確認を求めます。

フェーズ1 — SVGを分析する

python scripts/svg_inspect.py logo.svg trabajo/inspeccion/

inspeccion.png を表示し、グループを提案します。通常は、アイソタイプ / ロゴタイプ / タグラインですが、アイデンティティが動的(サブブランド、建物、拠点などで一部の色が変わる)な場合は、カラールールでグループ化します: 変わるもの、固定のもの、変わるものに付随するもの。これにより、各バリアントが1つの指示で生成されます。確認し、trabajo/grupos.json に保存します(例: {"prefijo": ["1-4"], "nombre": ["5-10"], "simbolo": [0]})。アラートに対処します: ライブテキスト、拡張されていないストローク、グラデーション、埋め込み画像。

フェーズ2 — インタビュー

references/entrevista.md に従います(6ブロック: 範囲 → ロゴ → カラー → タイポグラフィ → ビジュアル言語とアプリケーション → 文書管理)。 リスクの低い決定は同じメッセージで解決済みと見なせます(「修正しない限りXを仮定します」); 取り消すのにコストがかかるものは個別に扱います。

終了時に、結果の目次(コア + モジュール、ページ番号付き)を提示し、 何も作成する前に承認を待ちます。

フェーズ3 — ロゴのバリエーション(常に事前承認あり)

カラーバリエーション。 提案を生成し、シートとして表示します。その後、テーブル: バリアントグループ · 解決方法 · 使用法、およびあなたが下した決定。フェーズ5のコントラストテーブルで提起または解決すべき典型的な疑問:

  • ネガティブの場合、色はそのままか白になるか?カラーネガティブは、その色が暗い背景と十分なコントラスト(≥ 3:1)がある場合のみ存在します。そうでなければ白のモノクロ。
  • パレットの色である背景の上では、ロゴは1色(黒または白)で表示され、パレットの別の色では表示されません。
  • 1色の場合、内部のディテールが後ろの形状と混ざるか?カットアウト("calar")を提案します。
  • 動的アイデンティティの場合: 付随するピース(例: シンボル)が異なる色を取ることができるか?異なる色を取らないことを推奨し(1ピース=1色)、コストを述べます。
python scripts/logo_variants.py logo.svg trabajo/variantes.json trabajo/versiones/ --version apilada

リコンポジション(横 ↔ 縦、シンボルのみ、アバター、ロックアップ):

  1. SVGがすでに存在するか質問します。存在すればそれを使用します。
  2. 存在しなければ、compose.py で構成します: 既存のピースを再配置、スケーリング、分離するのみ。再描画はしません。 2行から1行にするには、各グループのベースライン(子孫のない文字の足)を揃え、単語内の文字間隔と等しい間隔を設定して、1つの単語として読めるようにします。
  3. プレビューを表示し(アバターの場合は _circulo.png も。ファビコンの場合は32pxと16pxでのテスト)、1つずつ承認を待ちます。
  4. 承認されたら、承認された各カラーバリアントを構成してバリアントを生成します(メインバージョンのSVGをループ)。

テキスト付きロックアップ(スローガン、サブブランド名、建物名): テキストをブランドフォントでアウトライン化し、インストールされているフォントに依存せず、外部ピースとして追加します:

python scripts/text_to_svg.py "Conecta. Vive. Pertenece." fuente.woff trabajo/slogan.svg --color "#1D1D1B"

(Google Fontsは npm i @fontsource/<family> で入手します。.woff を使用)。 compose.py では、"externos": {"slogan": "trabajo/slogan.svg"} および "ancho": {"slogan": "logo"} でスローガンの幅をロゴに合わせます。名前が未定義のサブブランドの場合は、プレースホルダー("[Nombre]")を残し、構造を正規化します。ロックアップのテキストは、ロゴの固定部分のインクで表示され、可変色では表示されません。

不適切な使用例(実際のロゴを使用):

python scripts/incorrect_uses.py trabajo/versiones/<principal>.svg trabajo/incorrectos/ --grupos g.json --nombre "<marca>" --fondo-malo "#2B57E2"

(g.json には、シンボルを含む isotipo グループと、残りを logotipo として指定する必要があります)。

フェーズ4 — グリッド、プロテクション、最小サイズ

  1. ユーザーがコンストラクティブグリッドを持っているか質問し、そのSVGをリクエストします。 持っている場合はそのまま使用します。持っていない場合:
  2. python scripts/construction.py candidatos logo.svg trabajo/constructivo/ --grupos trabajo/grupos.json を実行し、候補を1枚のシートに表示します。通常は2つを組み合わせるとうまく機能します: ストロークの太さを平面のモジュールとして(アセンダに当たる)、シンボルの幅をプロテクションエリアの尺度として(「シンボル1つ分のスペースを空ける」、どのサプライヤーにも説明しやすい)。コブランディング: 2倍。
  3. 各バージョンに対して python scripts/construction.py flat <version>.svg trabajo/constructivo/<version> --module <u> --protection <modules> を実行します。
  4. python scripts/min_size.py <version>.svg trabajo/minimos/<version> --grupos g.json(g.json には logotipo と、存在すれば tagline を指定)。細いスリット(シンボルの十字など)がある場合、スクリプトは2つのしきい値を提供します: [complete] すべてが読める / [legible] 名前が読めてシンボルは点として残る。各バージョンを様々なサイズ(実寸および拡大)でテストシートにまとめ、ユーザーに選択させます。通常: 公式の最小は [legible] であり、小さなフォーマット(署名、写真付きIDカード)では、シンボルはさらに別途大きく表示されます。

フェーズ5 — カラーシステム

  1. trabajo/colores.json を作成します: 色ごとに1つのソースHEX、ロール、ソースマテリアルからのRGB/CMYK/Pantoneを検証用に含めます。
  2. ユーザーが検証済みのPantoneを持っていない場合、作業を提供します: python scripts/pantone_ref.py trabajo/colores.json trabajo/pantone_ref.json(ΔE 2000による最も近いPantone CおよびテキスタイルTCX)。結果を colores.json にコピーし、ΔEとともにテーブルで提示します: < 2 ほぼ同一、2–5 類似、> 5 差が目立つ、> 10 同等なし。
  3. python scripts/color_system.py trabajo/colores.json trabajo/color/: FOGRA39プロファイルが見つかればそれを使用してCMYKに変換し、ガマット外の色を警告し(印刷時の見え方)、RGB/HEXを検証し、50–950スケールとコントラストマトリックスを計算します。
  4. デザインの前にアラートを提示します。 CMYKでくすんで見える色と、直接Pantoneが適した場所(ステッカー、サイネージ)を説明します。計算されたすべてのPantone/TCXは、マニュアルでは「参考値、物理ガイドとカラープルーフで検証すること」として記載します。公式として提示してはいけません。黒については、リッチブラック(広い領域)と0/0/0/100(テキスト)を区別します。
  5. コントラストマトリックスは、各背景に対するテキストのインクとロゴのインクを決定します。PPTが「Xは常に黒」と言っているのに、ある背景でコントラストがそれを妨げる場合は、その旨を述べ、修正ルールを提案します(「Xはコントラストのあるインクで」)。

フェーズ6 — タイポグラフィとライセンス

質問する前に、各フォントのライセンスをWebで確認します:

  • Google Fonts / OFL: 問題なし。
  • 「個人使用は無料」: 商用ロゴには対応していません。どこから入手したか質問します。
  • Envato Elements: ロゴをカバーしますが、そのプロジェクトのためにフォントを登録する必要があり、サブスクリプションが有効な間は登録し、証明書PDFを保存する必要があります。まだ行っていない場合、それが最も重要な未完了タスクです。マニュアルにライセンスコードのプレースホルダーを入れます。
  • システムに制限されている(例: SF Pro): 警告し、自由な代替案を提案します。

ロゴタイプのフォントは、アウトラインで提供される場合、「ロゴアート内でのみ使用。インストールしない」と宣言します。バックアップフォント(Google Docs / Canva および Word)と、ブランドのボイスで書かれた例を示す階層を定義します。

サードパーティのイラストレーション(ストックサイト、Figmaコミュニティ): そのライセンスも確認します(例: Streamline Freeは、帰属表示が必要、プロジェクトあたり25個まで、再配布禁止)。サードパーティに提供できない場合、マニュアルではクレジット付きのスタイルリファレンスとして表示し、.zipには含めません。Figmaから取得するには、公式コネクタ(create_session → get_metadata → get_screenshot、base64を使用。ファイルはディスクに保存されます)を使用します。Starterプランでは呼び出し回数が制限されています。ダウンロード前に位置を特定し選択します。ローカルのFigmaコネクタが「Token expired」を返した場合、トークンはファイル内ではなくアプリの設定(または設定 → 拡張機能)で変更します。その間は公式コネクタを使用するか、手動エクスポートを依頼します。

フェーズ7 — デッキを構築する

references/esqueleto-slides.md を読みます。Slidesタイプからデッキを作成します(タイトル: "Manual de marca – ")。ファイルの指示に従います:

  1. デッキに使用するすべてのもの(バージョン、平面図、最小サイズテスト、不適切な使用例、イラスト)を透明PNGにレンダリングし、作業ディレクトリのフォルダからリソースとしてアップロードします(1回の呼び出しで最大25ファイル)。
  2. 最初に deck.json を作成し、完全な order(コア + モジュール + セパレーター)と、faces にブランドフォント(Google Fonts)を含めます。次に表紙を作成し、その後6~8ページずつ作成します。
  3. 戦略テキスト: PPTから、マニュアルのレジスターで、主張を追加せずに。不足しているものは、ページとスピーカーノートの両方で角括弧("[correo]")で囲みます。
  4. 業種別アプリケーション: スライド上でシェイプ、ロゴのPNG、ブランドのボイスを使用したテキスト例で構築します。写真モックアップではありません。
  5. ヘッダーと目次でブランド名が正しいことを確認します。

フェーズ8 — ファイルパッケージ

承認されたSVGのみを、<version>_<variant>.svg という名前で(プレビューやばらばらのピースは含めず)フォルダにコピーし、次を実行します:

python scripts/package.py trabajo/entrega/ trabajo/paquete/ --marca "<Marca>"

バリアントごとにSVG、透明PNG 500/1000/2000 px、ベクターPDF(RGB)を生成します。CMYK/Pantoneバージョン、刺繍用簡略化バージョン、調整された16pxファビコンは、「アートファイナル未完了」として残ります。.zipをSendUserFileで送信します。

フェーズ9 — 納品

簡潔なメッセージ: デッキ(そのカードにはすでにリンクが含まれています)、.zip、および未完了リストを責任者別にグループ化(デザイナー / クライアント / 印刷会社)。例: フォントライセンスの登録、Pantoneの検証、ブランド責任者のメール、刺繍用アートファイナル、イラストライセンス。オプションとして、brand-board の実行またはテンプレートの作成を提供します。

良い例

このように、マニュアルでの決定は具体的、測定可能、かつ状態付きで文書化されます。

色 · 青
HEX #2B57E2 · RGB 43/87/226 · CMYK 85/65/0/0 (FOGRA39、いくぶんくすんで見える)
Pantone 2728 C · ΔE 3.1 (類似)。参考: 物理ガイドとカラープルーフで検証すること。

最小サイズ · 横バージョン
幅24 mm / 90 px: 名前は読め、シンボルは点として残る。
より小さい場合(署名、写真付きIDカード): シンボルを別途大きく使用する。

悪い例

公式Pantone: 2728 C
ロゴを小さくしすぎないこと。

なぜ悪いか: 計算されたPantoneをΔEなしで公式として提示しており、最小サイズに測定値がないため、どのサプライヤーも準拠しているか確認できません。

このスキルが決して行わないこと

  • ロゴの再描画または「改良」: 既存のピースの色変更、カットアウト、再配置、スケーリング、分離のみ。新しいテキストをアウトライン化して追加のみ。
  • 事前承認なしでのバージョン作成。
  • 戦略、ライセンス、クライアントデータの発明。計算されたPantoneを公式として提示しない。
  • 検証なしでの異なるソースからのカラー値の混合。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

関連スキル