Communitygithub.com

alecs5am/ralphy

Como criar um pôster de marca vívido e centrado em personagens — uma única imagem estática, não um vídeo. Uma sobreposição generalizada na etapa de direção de arte: fornece a arquitetura de pôster como landing page (faixa superior → letreiro colossal em bevel → foto do herói do peito para cima → colagem de adesivos dispersos → bloco de texto → rodapé fino), o conjunto de parâmetros (marca, palavra de exclamação, herói, produto, paleta, glifo blob original, registro estético), a pilha de modelos (gpt-5.4-image-2 para tipografia nítida, fallback gemini) e os modos de falha do nicho. Funciona para QUALQUER marca e QUALQUER estética que o usuário nomear — Y2K streetwear, vaporwave, zine grunge, DTC limpo — a habilidade fornece o conhecimento de layout, o usuário fornece o assunto + a vibe.

O que é ralphy?

O **alecs5am/ralphy** é uma habilidade especializada em design de pôsteres estáticos de alto impacto para marcas, operando dentro de um ecossistema de ferramentas de IA (como uma skill para Claude Code ou similar). Ela atua como uma sobreposição de processo na etapa de direção de arte, fornecendo uma arquitetura fixa de pôster (tipo landing page) e um conjunto de parâmetros que o usuário preenche para obter resultados consistentes e de qualidade profissional. A habilidade é agnóstica em relação a assunto e estilo, funcionando para qualquer marca e qualquer estética que o usuário desejar (Y2K, vaporwave, grunge, DTC limpo, etc.). Ela define uma estrutura de layout rígida e de alto nível: faixa superior com tagline, um letreiro enorme em bevel, foto do herói (do peito para cima), colagem de adesivos, bloco de cópia e um rodapé fino. Todos os slots (marca, herói, produto, paleta, glifo blob original, estética) são preenchidos pelo usuário ou pelo processo, garantindo que a criatividade seja canalizada para um formato testado e aprovado. Para obter tipografia nítida e precisa (crucial para o letreiro e o bloco de cópia), o modelo padrão recomendado é o `openai/gpt-5.4-image-2`, com fallback para o `google/gemini-3-pro-image-preview` para exploração rápida de paletas. A habilidade também implementa verificações de qualidade rigorosas, incluindo uma 'quality gate' que se recusa a prosseguir após duas falhas consecutivas de `scoreImage`. Para marcas reais, ela exige um pré-voo de pesquisa via subagente Playwright para fundamentar a paleta e os elementos de copy nos dados reais do site da marca, evitando alucinações de SDK e outros erros comuns.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Gatilho

DISPARA em um briefing genérico de pôster estático: "faça um pôster para ", "pôster de drop", "pôster como landing page", "flyer", "key art", "gráfico hype", "imagem estilo capa de álbum", "imagem de anúncio de drop de merch". Qualquer assunto, qualquer estética — a habilidade é agnóstica em relação a assunto e estilo.

NÃO DISPARA quando:

  • O usuário aponta para um pôster específico para reproduzir (@template:<slug>, "remix este aqui", nomeia um slug) → esse é o caminho de remix. Veja docs/skills-vs-templates.md.
  • O usuário quer um vídeo em movimento (o letreiro anima, o herói fala) → corresponda ao formato de vídeo / template, carregue a habilidade de sobreposição de craft de vídeo correspondente (ugc-*) e use o playbook do editor, não esta habilidade.
  • O usuário colou @guideline:<slug> para um registro em que este pôster se encaixa (humanos fotorrealistas, anti-AI-slop) → execute ralphy guideline show <slug> primeiro e incorpore suas regras no slot da foto do herói.

O que esta habilidade é

Uma sobreposição de layout generalizada, não um pôster finalizado. Ela não nomeia uma marca, um herói ou uma paleta — ela diz ao diretor de arte COMO esta classe de pôster é construída para que um pôster forte seja gerado para o que quer que o usuário esteja promovendo. Ela é executada através de ralphy generate image; ela não ignora a porta de exigência de referência nem a porta de qualidade.

Invariantes rígidas

  • Toda geração passa por ralphy generate image (sem API bruta). Leia MODELS.md antes de nomear qualquer id de modelo — a pilha abaixo é um padrão, não um código fixo.
  • A porta de exigência de referência ainda dispara para uma entidade real nomeada no slot de herói ou produto (uma pessoa real, um produto de marca reconhecível, uma propriedade intelectual). Uma marca fictícia + um glifo original + um produto genérico prosseguem sem uma referência. Torne o glifo da marca EXPLICITAMENTE ORIGINAL no prompt ("NÃO qualquer marca existente") para que o modelo não derive em direção a uma marca registrada.
  • A porta de qualidade recusa, não avisa — duas falhas consecutivas de scoreImage → pare e relate opções.
  • Pré-voo de marca real: fundamentação no site antes de qualquer prompt. Se o pôster for direcionado a uma marca real (startup do próprio usuário, site de um cliente, qualquer URL fornecida), despache um subagente Playwright para rastrear a home + /docs + /pricing + /features + /examples ANTES de redigir o DNA da marca ou o prompt. Leia artifacts/refs/research.md (o resumo do subagente), não apenas um WebFetch da página inicial. Cada {{palette}} hex deve ser rastreado até artifacts/refs/tokens.json; todo símbolo de API nomeado no corpo do texto ou nos slots criativos de código deve ser rastreado até "Superfícies de API documentadas" em research.md. Disciplina completa + modelo de prompt do subagente: .agents/skills/researcher/references/site-grounding.md. Pular isso custou ao sotaocr-fb-001 $1,20 + 5/32 criativos de SDK alucinados.

O nicho, em um parágrafo

Um pôster como landing page vive ou morre por um letreiro enorme e legível mais um único personagem fazendo contato visual ou quase visual, unidos por energia de colagem de adesivos DIY. O olho deve pousar na palavra, depois no rosto, depois saltar por 2-3 acentos de adesivos e, em seguida, ler o texto. A tipografia nítida é o jogo inteiro — um letreiro borrado o mata instantaneamente, e é por isso que a escolha do modelo é baseada primeiro na tipografia, não na consistência.

A arquitetura fixa (não reestruture — apenas preencha os slots)

De cima para baixo, todo pôster neste nicho mantém esta pilha:

FaixaFunção fixaSlot(s) a preencher
1. Faixa superiorlinha de introdução pequena em caixa alta espaçada{{tagline}}, cor de destaque
2. LetreiroENORME slab-serif encorpado, sombra bevel 3D, destaque cromado por letra, leve inclinação lúdica + terminais imperfeitos{{exclamation}} (palavra curta impactante: BOOM / DANG / YIKES / WOW / OOPS)
3. Foto do herói (~60% altura)retrato cinematográfico do peito para cima, olhar para cima, casual-cool, glifo blob original no peito, um produto segurado na altura da boca, luz de borda suave, grão de filme{{hero}}, {{product}}, {{blob_glyph}}
4. Colagem de adesivos3 adesivos de vinil (borda branca fina + sombra projetada suave + canto com fita), espalhados em ângulos lúdicosestrela com macro do produto · estrela com cara de blob · estrela pequena com etiqueta "NOVO DROP" em pixel
5. Bloco de cópiatítulo em caixa alta condensado + 4 linhas de corpo em itálico serifado + pílula de CTA preenchida{{headline}}, {{body_copy}}, {{cta}}
6. Faixa de rodapécaixa alta espaçada muito fina em largura total{{brand}} · EST. YYYY · <tagline do processo> · WWW.<domain>

Camada de finalização (sempre ativa): grão de filme sutil + vinheta leve + calor CRT suave + sensação de serigrafia vintage.

Slots (as únicas coisas que mudam entre pôsteres)

  • {{brand}} + {{tagline}} + {{domain}} — o rótulo fictício (ou de propriedade do usuário).
  • {{exclamation}} — a palavra do letreiro. Um token curto e gritável.
  • {{hero}} — pessoa + guarda-roupa + expressão. Varie idade/gênero/estilo livremente.
  • {{product}} — o adereço segurado na altura da boca (pirulito, picolé, lata de refrigerante, microfone, …). Mantenha genérico/sem marca, a menos que o usuário seja dono da marca.
  • {{palette}} — gradiente de fundo sangrado (2 hex) + cor de destaque (letreiro/título) + cor de sombra bevel + cor creme do corpo + carvão do contorno + cor do produto. Sempre declare hex explícito.
  • {{blob_glyph}} — uma criatura amigável ORIGINAL rabiscada à mão (blob sorridente, nuvem ciclope, estrela torta). A palavra da marca em minúsculas escrita dentro dela. Declare "NÃO qualquer marca existente."
  • {{aesthetic}} — o registro (Y2K skate-surf streetwear é o padrão validado; vaporwave, zine grunge, DTC limpo, arcade anos 90 todos funcionam no mesmo arcabouço).

Pilha de modelos (verifique em relação a MODELS.md a cada execução)

  • Padrão — openai/gpt-5.4-image-2. Tipografia premium / precisão de rótulos: o letreiro em bevel, a faixa de rodapé pequena e as 4 linhas do corpo do texto são todos nítidos e legíveis. Esta é a razão pela qual ele supera o padrão focado em consistência para pôsteres. Limitado a 1 concorrente — serialize lotes (--concurrency 1), nunca dispare gerações paralelas de pôsteres neste modelo.
  • Fallback — google/gemini-3-pro-image-preview. ~½ da latência e mais barato, tolera ≥4 concorrentes, mas borra tipografia pequena incorporada (postmortem flipper; confirmado novamente no loud-kids-poster-001 — as 4 linhas do corpo do texto ficaram suaves). Use apenas para exploração rápida de paleta/composição, depois finalize a variante escolhida no gpt-image.

Proporção de aspecto — resolvida, use --size

gpt-5.4-image-2 historicamente retornava 1024² independentemente de --size. A partir da sessão loud-kids-poster-001, ralphy generate image encaminha image_config.aspect_ratio (derivado de --size) para OpenRouter, e o gpt-image o honra: --size 1080x1920 → um retrato 9:16 real (bucket nativo 720×1280). Passe --size 1080x1920 para um pôster vertical de landing page, --size 1080x1080 para uma postagem social quadrada. A saída cai no bucket nativo mais próximo do modelo, não exato em pixels — preencha/redimensione downstream se precisar de um quadro exato.

Modos de falha

  • Gens paralelas de gpt-image → 403 "Key limit exceeded". Serialize (o limite de 1 concorrente). Cada gen também leva ~2,5-4 min.
  • Gemini borra o bloco de cópia do corpo + a faixa de rodapé. Não finalize um pôster com muita tipografia no gemini.
  • Glifo deriva em direção a uma marca registrada real (marcas sorridentes, etc.) se você não disser "original, NÃO qualquer marca existente" — sempre inclua essa cláusula.
  • Adesivos demais → o olho não tem onde descansar. Limite a 3, mantenha-os nas bordas do herói.
  • Letreiro + título da mesma cor que um fundo ocupado → a legibilidade morre. O destaque do letreiro deve contrastar fortemente com o gradiente.

Exemplo prático (validado em 27/05/2026)

.ralphy/workspaces/<ws>/projects/loud-kids-poster-001/ contém três variantes de paleta/herói/produto construídas neste arcabouço exato (BOOM/azul real+pirulito, DANG/coral-ameixa+picolé, YIKES/lima-floresta+refrigerante) mais um A/B 9:16 (gpt-image vs gemini). Os três arquivos de prompt (prompt-v1-boom.txt …) são a referência canônica de slots preenchidos — leia um antes de redigir um novo prompt de pôster.

Livro de receitas CLI

# Pôster padrão, vertical 9:16, tipografia nítida
ralphy generate image --project <id> --slot poster-01 \
  --model openai/gpt-5.4-image-2 --size 1080x1920 --prompt "<arcabouço preenchido>"

# Exploração rápida de paleta/composição (finalize o vencedor no gpt-image depois)
ralphy generate image --project <id> --slot poster-explore --variants 3 \
  --model google/gemini-3-pro-image-preview --size 1080x1920 --prompt "<...>"

# Corte quadrado para rede social do mesmo pôster
ralphy generate image --project <id> --slot poster-01-sq \
  --model openai/gpt-5.4-image-2 --size 1080x1080 --prompt "<arcabouço preenchido>"

Prompts longos: escreva o arcabouço preenchido em um .txt no diretório do projeto e passe --prompt "$(cat arquivo.txt)" — apóstrofos no corpo do texto quebram strings shell inline com aspas simples.

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.

Habilidades Relacionadas