Communitygithub.com

alecs5am/ralphy

鮮やかでキャラクター主導のブランドポスター — 動画ではなく静止画 — を作成する方法。アートディレクターステップに汎用的なオーバーレイを提供し、ポスターをランディングページとして構成するアーキテクチャ(トップバナー、大きなベベルワードマーク、胸から上のヒーロー写真、散りばめられたビニールステッカーコラージュ、コピーブロック、細いフッターストリップ)、パラメータ化されたスロットセット(ブランド、感嘆詞、ヒーロー、プロダクト、パレット、オリジナルのブロブグリフ、美的レジスター)、モデルスタック(gpt-5.4-image-2、geminiフォールバック)、およびニッチな失敗モードを提供します。ユーザーが指定する任意のブランドと任意の美学(Y2Kストリートウェア、ヴェイパーウェイヴ、グランジジン、クリーンなDTC)に対応し、スキルがレイアウトのノウハウを提供し、ユーザーが主題と雰囲気を提供します。

ralphy とは?

このスキルは、汎用的な静止画ポスターブリーフに対応するための、レイアウト構成とアートディレクションのベストプラクティスを提供します。ユーザーがブランド名や大まかな美学(Y2K、ヴェイパーウェイヴ、グランジなど)を指定した場合、このスキルは検証済みの6層構造(トップバナー、大型ベベルワードマーク、胸から上のヒーロー写真、ステッカーコラージュ、コピーブロック、フッター)に従ってポスターを構成します。このスキルは、特定のポスターを再現する場合(`@template`)や動画が必要な場合には適用されません。デフォルトでは`openai/gpt-5.4-image-2`を使用してシャープなタイポグラフィを実現し、高速な探索用に`google/gemini-3-pro-image-preview`をフォールバックとして使用します。実在のブランドを対象とする場合は、プロンプト作成前にPlaywrightサブエージェントを使用してサイトグラウンディングを実行し、品質ゲート(`scoreImage`)とリファレンス必須ゲートを適用します。

対応~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/alecs5am/ralphy/tree/HEAD/.agents/skills/poster

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

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

ドキュメント

トリガー

起動条件 汎用的な静止画ポスターブリーフ: "のポスターを作って"、"ドロップポスター"、"ポスター型ランディングページ"、"フライヤー"、"キーアート"、"ハイプグラフィック"、"アルバムカバースタイルの静止画"、" 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)"を渡します。ボディコピー内のアポストロフィは、インラインのシングルクォートで囲まれたシェル文字列を壊します。

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

alecs5am/ralphy

>- Composition and render craft — assembles scenario.json plus asset-manifest.json into a HyperFrames HTML composition and renders the mp4. Owns timing, transitions, captions, audio mix and ducking, the green zone, the render pipeline, and VO sync. Generates no media of its own. USE WHEN the user asks to "compose the video", "render", "preview", "fix the captions", "mix the audio", "tighten the transitions", "final cut", or edits HyperFrames composition code. TRIGGER (EN): "render it", "compose the video", "captions", "audio mix", "transitions", "final cut", "preview the composition".

alecs5am/ralphy

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

alecs5am/ralphy

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

alecs5am/ralphy

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

alecs5am/ralphy

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

alecs5am/ralphy

>- Compatibility shim for the legacy `/ralphy-remotion` skill name. Use when a saved Claude Code command, old project note, or user request still mentions Ralphy Remotion; redirect the task to HyperFrames and the current Ralphy render playbooks instead of authoring new Remotion code.

alecs5am/ralphy

>- Compatibility shim for the legacy `/remotion-to-hyperframes` skill name. Use when an old project, note, or user request asks to migrate Ralphy Remotion work; translate the intent into the current HyperFrames composition model and follow the editor and HyperFrames playbooks.

alecs5am/ralphy

The full extract → classify → blueprint → de-dup → publish pipeline for a finished `.ralphy/workspaces/<ws>/projects/<id>/`. Reads its `units/*/unit.json` (#069) as the Unit source of truth, then factors the project into ALL FIVE entities — Unit + the four typed blocks Template (structure), Style (look), Recipe (effect/treatment), Asset (reusable media). Applies the recipe-vs-tag split (#082/#083): a candidate is a Recipe only if it carries an extractable artifact (ffmpeg filtergraph / HyperFram

alecs5am/ralphy

>- How to make a realistic AI UGC ad for a product — generalized niche know-how that looks real and doesn't feel AI. A domain overlay on the standard pipeline: supplies the shooting-script shape (timestamp | VO | shot | mannerism), the creator-persona build, the problem-mirror hook, the trust-through-mannerisms rule, and the 9:16 ~15s UGC format defaults. Works for ANY product the user names — their skincare line, a no-name app, a gadget. The skill supplies the know-how; the user supplies the product. USE WHEN the user asks for a UGC ad / creator-style product ad / "make an ad that looks like a real person reviewing my product" / testimonial-style or problem-solution short for TikTok / Reels / Shorts, with no specific existing video to reproduce. This is a niche SKILL (generalized), not a remix TEMPLATE. For "remix this exact ad but swap the product/person", use the remix path (docs/skills-vs-templates.md). For swapping the creator in an existing clip, see /ugc-model-swap.

alecs5am/ralphy

When the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing strategies,' 'marketing tactics,' 'ways to promote,' 'ideas to grow,' 'what else can I try,' 'I don't know how to market this,' 'brainstorm marketing,' or 'what marketing should I do.' Use this as a starting point whenever someone is stuck or looking for inspiration on how to grow. For specific channel execution, see the relevant skill (paid-ads, social-content, email-sequence, etc.).

alecs5am/ralphy

Full end-to-end workflow for generating a realistic AI UGC ad for a product. 15-second format. Looks real. Doesn't feel AI.

関連スキル