トリガー
起動条件 汎用的な静止画ポスターブリーフ: "のポスターを作って"、"ドロップポスター"、"ポスター型ランディングページ"、"フライヤー"、"キーアート"、"ハイプグラフィック"、"アルバムカバースタイルの静止画"、" merchドロップ告知画像"。どんな主題や美学でも対応します — このスキルは主題とスタイルに依存しません。
起動しない条件:
- ユーザーが再現する特定のポスターを指定している場合(
@template:<slug>、"これをリミックスして"、スラグを指定)→ それはリミックスパスです。docs/skills-vs-templates.mdを参照してください。 - ユーザーが動画を希望している場合(ワードマークがアニメーションする、ヒーローが話す)→ 動画フォーマット/テンプレートにマッチさせ、対応する動画クラフトオーバーレイスキル(
ugc-*)をロードし、エディタープレイブックを使用します。このスキルは使用しません。 - ユーザーが
@guideline:<slug>を貼り付けて、このポスターが従うべきレジスター(フォトリアルな人間、AIスロップ回避)を指定している場合→ 最初にralphy guideline show <slug>を実行し、そのルールをヒーローフォトスロットに組み込みます。
このスキルの概要
完成したポスターではなく、汎用的なレイアウトオーバーレイです。ブランド、ヒーロー、パレットを指定するわけではありません。アートディレクターに対して、このクラスのポスターがどのように構築されるかを伝え、ユーザーが宣伝しているものに対して強力なポスターが生成されるようにします。このスキルはralphy generate imageを通じて実行されます。リファレンス必須ゲートや品質ゲートをバイパスしません。
不変のルール
- すべての生成は
ralphy generate imageを経由します(生のAPIは使用不可)。モデルIDを指定する前にMODELS.mdを読んでください。以下のスタックはデフォルトであり、ハードコードではありません。 - ヒーローまたはプロダクトスロットに名前付きの実在エンティティ(実在の人物、認識可能なブランド製品、IP)がある場合、リファレンス必須ゲートが作動します。架空のブランド+オリジナルのグリフ+汎用製品の場合は、リファレンスなしで進みます。ブランドグリフはプロンプトで明示的に「オリジナル」("NOT any existing brand")と指定し、モデルが商標登録されたマークにドリフトしないようにします。
- 品質ゲートは警告ではなく拒否します —
scoreImageが2回連続で失敗した場合→ 停止してオプションを報告します。 - 実在ブランドの事前確認: プロンプト作成前のサイトグラウンディング。ポスターが実在のブランド(ユーザー自身のスタートアップ、顧客のサイト、任意のURL)を対象とする場合、Playwrightサブエージェントを起動し、ブランドDNAやプロンプトを作成する前に、ホームページ、
/docs、/pricing、/features、/examplesをクロールします。ホームページのWebFetchだけでなく、artifacts/refs/research.md(サブエージェントのダイジェスト)を読み込んでください。{{palette}}のすべての16進数カラーはartifacts/refs/tokens.jsonにトレース可能である必要があります。ボディコピーやコードクリエイティブスロット内の名前付きAPIシンボルは、research.mdの「文書化されたAPIサーフェス」にトレース可能である必要があります。完全な規律とサブエージェントプロンプトテンプレート:.agents/skills/researcher/references/site-grounding.md。これをスキップすると、sotaocr-fb-001で$1.20 + 5/32の幻覚SDKクリエイティブが発生しました。
ニッチの説明(1パラグラフ)
ポスター型ランディングページの成否は、1つの巨大で読みやすいワードマークとアイコンタクト(またはそれに近い)をする単一のキャラクター、そしてそれらをDIYステッカーコラージュのエネルギーで接着することにかかっています。視線はまずワードに、次に顔に、そして2〜3のステッカーアクセントに飛び、最後にコピーを読みます。鮮明なタイポグラフィがすべてです — ワードマークがぼやけていると即座に失敗します。そのため、モデルの選択は一貫性よりもタイポグラフィを優先します。
固定アーキテクチャ(再構築せず、スロットのみを埋めること)
上から下まで、このニッチのすべてのポスターは次のスタックを維持します:
| バンド | 固定された役割 | 埋めるスロット |
|---|---|---|
| 1. トップバナー | 小さいトラッキングされた大文字のイントロ行 | {{tagline}}、アクセントカラー |
| 2. ワードマーク | 巨大などっしりとしたスラブセリフ、3Dベベルシャドウ、文字ごとのクロームハイライト、わずかに遊び心のある傾きと不完全な終端 | {{exclamation}}(短いパンチの効いた単語: BOOM / DANG / YIKES / WOW / OOPS) |
| 3. ヒーローフォト(約60%の高さ) | 映画的な胸から上のポートレート、上向きの視線、カジュアルでクール、胸にオリジナルのブロブグリフ、口元の高さで持つプロダクト、柔らかいリムライト、フィルムグレイン | {{hero}}、{{product}}、{{blob_glyph}} |
| 4. ステッカーコラージュ | 3枚のビニールステッカー(細い白い枠線+柔らかい落ち影+テープの角)、遊び心のある角度で散りばめ | プロダクトマクロの星・ブロブの顔の星・「NEW DROP」タイプのラベルが付いた小さな星 |
| 5. コピーブロック | 凝縮された大文字の見出し+4行のイタリックセリフ本文+塗りつぶされたCTAピル | {{headline}}、{{body_copy}}、{{cta}} |
| 6. フッターストリップ | 非常に細い全幅トラッキング大文字 | {{brand}} · EST. YYYY · <プロセスタグライン> · WWW.<ドメイン> |
仕上げレイヤー(常に適用): 微妙なフィルムグレイン+わずかなビネット+かすかなCRTのような温かみ+ヴィンテージのスクリーンプリントのような質感。
スロット(ポスター間で変更される唯一の部分)
{{brand}}+{{tagline}}+{{domain}}— 架空の(またはユーザー所有の)ラベル。{{exclamation}}— ワードマークの単語。短く叫べるトークン1つ。{{hero}}— 人物+衣装+表情。年齢、性別、スタイルは自由に変えてください。{{product}}— 口元の高さで持つ小道具(ロリポップ、アイスキャンディー、ソーダ缶、マイクなど)。特にユーザーがブランドを所有している場合を除き、汎用的/非ブランドのままにしてください。{{palette}}— 全面bleedの背景グラデーション(2つの16進数)+アクセントカラー(ワードマーク/見出し)+ベベルシャドウカラー+クリーム色のボディカラー+線画のチャコールグレー+プロダクトカラー。常に明示的に16進数を指定してください。{{blob_glyph}}— オリジナルの手書き風の親しみやすい生き物(スマイリーブロブ、一つ目雲、いびつな星)。その中にブランドの小文字の単語を書きます。「既存のブランドではありません(NOT any existing brand)」と明記してください。{{aesthetic}}— レジスター(Y2Kスケートサーフストリートウェアが検証済みのデフォルトです。ヴェイパーウェイヴ、グランジジン、クリーンなDTC、90年代アーケードスタイルも同じフレームワークで機能します)。
モデルスタック(実行のたびにMODELS.mdで確認)
- デフォルト —
openai/gpt-5.4-image-2。プレミアムなタイポグラフィ/ラベルの正確さ: ベベル加工されたワードマーク、小さなフッターストリップ、4行のボディコピーがすべて鮮明に読めます。これが、ポスターにおいて一貫性優先のデフォルトモデルに勝る理由のすべてです。同時実行は最大1 — バッチを直列化し(--concurrency 1)、このモデルでポスター生成を並列実行しないでください。 - フォールバック —
google/gemini-3-pro-image-preview。約半分のレイテンシで低コスト、4以上の同時実行に耐えますが、小さな埋め込みタイポグラフィをぼかします(フリッパーの事後分析で確認; loud-kids-poster-001でも再確認 — 4行のボディコピーが柔らかくなりました)。高速なパレット/構図の探索にのみ使用し、選択したバリアントはgpt-imageで最終決定してください。
アスペクト比 — 解決済み、--sizeを使用
gpt-5.4-image-2はこれまで--sizeに関係なく1024²を返していました。loud-kids-poster-001セッション以降、ralphy generate imageはimage_config.aspect_ratio(--sizeから派生)をOpenRouterに転送し、gpt-imageはそれを尊重します: --size 1080x1920 → 実際の9:16ポートレート(ネイティブバケット720×1280)。縦長のランディングポスターには--size 1080x1920、正方形のソーシャル投稿には--size 1080x1080を渡してください。出力はモデルの最も近いネイティブバケットに配置され、ピクセル完全ではありません。正確なフレームが必要な場合は、後段でパディング/スケーリングしてください。
失敗モード
- gpt-imageの並列生成 →
403 "Key limit exceeded"。直列化します(1同時実行制限)。各生成には約2.5〜4分かかります。 - Geminiがボディコピーとフッターストリップをぼかす。タイポグラフィが重要なポスターをGeminiで最終決定しないでください。
- グリフが実際の商標にドリフトする(スマイリーブランドなど)「オリジナル、既存のブランドではありません」と指定しない場合 — 必ずその条項を含めてください。
- ステッカーが多すぎる → 視点の休まる場所がなくなります。3つまでに制限し、ヒーローの端に配置してください。
- ワードマーク+見出しが背景と同じ色 → 読みやすさが失われます。ワードマークのアクセントはグラデーションと強くコントラストを付ける必要があります。
実例(2026-05-27検証済み)
.ralphy/workspaces/<ws>/projects/loud-kids-poster-001/には、この正確なフレームワーク(BOOM/ロイヤルブルー+ロリポップ、DANG/コーラルプラム+アイスキャンディー、YIKES/ライムフォレスト+ソーダ)に基づいて構築された3つのパレット/ヒーロー/プロダクトのバリアントと、9:16のA/B比較(gpt-image vs gemini)が含まれています。3つのプロンプトファイル(prompt-v1-boom.txt …)は正規のスロット埋め参照です。新しいポスタープロンプトを作成する前に1つ読んでください。
CLIクックブック
# デフォルトポスター、縦9:16、鮮明なタイポグラフィ
ralphy generate image --project <id> --slot poster-01 \
--model openai/gpt-5.4-image-2 --size 1080x1920 --prompt "<埋められたフレームワーク>"
# 高速パレット/構図探索(選択したバリアントを後でgpt-imageで最終決定)
ralphy generate image --project <id> --slot poster-explore --variants 3 \
--model google/gemini-3-pro-image-preview --size 1080x1920 --prompt "<...>"
# 同じポスターの正方形ソーシャル投稿用切り抜き
ralphy generate image --project <id> --slot poster-01-sq \
--model openai/gpt-5.4-image-2 --size 1080x1080 --prompt "<埋められたフレームワーク>"
長いプロンプト: 埋められたフレームワークをプロジェクトディレクトリ内の.txtファイルに書き込み、--prompt "$(cat file.txt)"を渡します。ボディコピー内のアポストロフィは、インラインのシングルクォートで囲まれたシェル文字列を壊します。