Communitygithub.com

alecs5am/ralphy

Crea un póster de marca vibrante y centrado en personajes: una sola imagen fija, no un video. Una superposición generalizada para el paso de dirección de arte, que suministra la arquitectura del póster como página de aterrizaje, el conjunto de parámetros, la pila de modelos y los modos de fallo del nicho.

¿Qué es ralphy?

Este skill, `alecs5am/ralphy`, es una superposición de oficio de nicho de contenido para generar pósters de marca estáticos y vibrantes, centrados en personajes. A diferencia de una plantilla fija, `ralphy` proporciona la arquitectura y el conocimiento de diseño para construir un póster desde cero, adaptable a cualquier marca, producto y estética (Y2K, vaporwave, grunge, DTC, etc.). Está diseñado para plataformas de agentes de IA como Claude Code o Cursor, y se ejecuta a través del comando `ralphy generate image`. El skill define una estructura fija de seis bandas verticales: banner superior, wordmark masivo, foto de héroe, collage de pegatinas, bloque de copia y pie de página. El usuario solo debe llenar los parámetros (`{{brand}}`, `{{hero}}`, `{{palette}}`, `{{aesthetic}}`, etc.). La pila de modelos prioriza la tipografía nítida usando `openai/gpt-5.4-image-2` como predeterminado, con `google/gemini-3-pro-image-preview` como fallback para exploración rápida. El skill impone invariantes críticos como el ruteo obligatorio a través de `ralphy generate image`, un control de calidad que rechaza en lugar de advertir, y una verificación previa de marca real mediante un sub-agente Playwright para evitar alucinaciones y costos innecesarios. Los modos de fallo documentados incluyen límites de concurrencia, difuminado de tipografía en Gemini y desviación de glifos hacia marcas registradas.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Disparador

SE ACTIVA con una solicitud genérica de póster fijo: "haz un póster para ", "póster de lanzamiento", "póster como página de aterrizaje", "flyer", "arte clave", "gráfico hype", "imagen fija estilo portada de álbum", "imagen de anuncio de lanzamiento de mercancía". Cualquier tema, cualquier estética: el skill es agnóstico al tema y al estilo.

NO SE ACTIVA cuando:

  • El usuario señala un póster específico para reproducir (@template:<slug>, "remezcla este", nombra un slug) → ese es el camino de remezcla. Consulta docs/skills-vs-templates.md.
  • El usuario quiere un video en movimiento (la marca de palabras se anima, el héroe habla) → coincide con el formato/plantilla de video, carga el skill de superposición de oficio de video correspondiente (ugc-*) y usa el manual del editor, no este skill.
  • El usuario pegó @guideline:<slug> para un registro en el que se encuentra este póster (humanos fotorrealistas, anti-IA-cutre) → ejecuta ralphy guideline show <slug> primero e incorpora sus reglas en la ranura de la foto del héroe.

Qué es este skill

Una superposición de diseño generalizada, no un póster terminado. No nombra una marca, un héroe o una paleta: le dice al director de arte CÓMO se construye esta clase de póster para que salga uno bueno para lo que sea que el usuario esté promocionando. Se ejecuta a través de ralphy generate image; no elude la puerta de requisito de referencia ni la puerta de calidad.

Invariantes estrictos

  • Toda generación pasa por ralphy generate image (sin API directa). Lee MODELS.md antes de nombrar cualquier ID de modelo: la pila siguiente es un valor predeterminado, no un valor fijo.
  • La puerta de requisito de referencia aún se activa para una entidad real nombrada en la ranura del héroe o del producto (una persona real, un producto de marca reconocible, una propiedad intelectual). Una marca ficticia + un glifo original + un producto genérico proceden sin referencia. Haz que el glifo de la marca sea EXPLÍCITAMENTE ORIGINAL en el prompt ("NO cualquier marca existente") para que el modelo no derive hacia una marca registrada.
  • La puerta de calidad rechaza, no advierte: dos scoreImage fallidos consecutivos → detente e informa opciones.
  • Verificación previa de marca real: fundamentación del sitio antes de cualquier prompt. Si el póster está dirigido a una marca real (startup propia del usuario, sitio web de un cliente, cualquier URL proporcionada), despacha un sub-agente Playwright para rastrear inicio + /docs + /pricing + /features + /examples ANTES de redactar el ADN de la marca o el prompt. Lee artifacts/refs/research.md (el resumen del sub-agente), no solo un WebFetch de la página de inicio. Cada {{palette}} hex debe rastrearse hasta artifacts/refs/tokens.json; cada símbolo de API nombrado en el cuerpo del texto o en las ranuras creativas de código debe rastrearse hasta "Superficies de API documentadas" en research.md. Disciplina completa + plantilla de prompt del subagente: .agents/skills/researcher/references/site-grounding.md. Omitir esto le costó a sotaocr-fb-001 $1.20 + 5/32 creativos de SDK alucinados.

El nicho, en un párrafo

Un póster como página de aterrizaje vive o muere por una marca de palabras masiva y legible más un solo personaje que hace contacto visual o casi visual, unidos por energía de collage de pegatinas DIY. El ojo debe caer en la palabra, luego en la cara, luego rebotar en 2-3 acentos de pegatinas, luego leer el texto. La tipografía nítida lo es todo: una marca de palabras borrosa lo mata al instante, por lo que la elección del modelo es primero la tipografía, no la consistencia.

La arquitectura fija (no reestructures — solo llena las ranuras)

De arriba a abajo, cada póster en este nicho mantiene esta pila:

BandaRol fijoRanura(s) a llenar
1. Banner superiorpequeña línea de introducción en mayúsculas y espaciado{{tagline}}, color de acento
2. Marca de palabrasMASA, slab-serif robusta, sombra biselada 3D, resaltado cromado por letra, ligera inclinación juguetona + terminales imperfectos{{exclamation}} (palabra corta y contundente: BOOM / DANG / YIKES / WOW / OOPS)
3. Foto del héroe (~60% altura)retrato cinematográfico de medio pecho hacia arriba, mirada hacia arriba, casual-cool, glifo blob original en el pecho, un producto sostenido a la altura de la boca, luz de borde suave, grano de película{{hero}}, {{product}}, {{blob_glyph}}
4. Collage de pegatinas3 pegatinas de vinilo (borde blanco delgado + sombra paralela suave + esquina de cinta), esparcidas en ángulos divertidosestrella con macro del producto · estrella con cara blob · estrella pequeña con etiqueta tipo "NUEVO LANZAMIENTO" en píxeles
5. Bloque de textotitular en mayúsculas condensadas + 4 líneas de cuerpo en serifa cursiva + píldora CTA rellena{{headline}}, {{body_copy}}, {{cta}}
6. Franja de pie de páginamuy delgada, mayúsculas espaciadas a todo lo ancho{{brand}} · EST. AAAA · <lema del proceso> · WWW.<dominio>

Capa de acabado (siempre activa): sutil grano de película + viñeta ligera + leve calidez CRT + sensación de serigrafía vintage.

Parámetros (las únicas cosas que cambian entre pósters)

  • {{brand}} + {{tagline}} + {{domain}} — la etiqueta ficticia (o propiedad del usuario).
  • {{exclamation}} — la palabra de la marca de palabras. Una ficha corta y gritable.
  • {{hero}} — persona + vestuario + expresión. Varía libremente edad/género/estilo.
  • {{product}} — el accesorio sostenido a la altura de la boca (piruleta, paleta, lata de refresco, micrófono, …). Mantenlo genérico/sin marca a menos que el usuario sea propietario de la marca.
  • {{palette}} — degradado de fondo a sangre completa (2 hex) + color de acento (marca de palabras/titular) + color de sombra biselada + color de cuerpo crema + carbón de delineado + color del producto. Siempre indica hex específico.
  • {{blob_glyph}} — una criatura amigable ORIGINAL garabateada a mano (blob sonriente, nube ciclope, estrella torcida). La palabra de la marca en minúsculas escrita dentro. Indica "NO cualquier marca existente".
  • {{aesthetic}} — el registro (Y2K skate-surf streetwear es el predeterminado validado; vaporwave, zine grunge, DTC limpio, arcade-90s todos funcionan en el mismo andamio).

Pila de modelos (verificar contra MODELS.md en cada ejecución)

  • Predeterminado — openai/gpt-5.4-image-2. Tipografía premium / precisión de etiquetas: la marca de palabras biselada, la pequeña franja del pie de página y las 4 líneas de texto del cuerpo se leen nítidas. Esta es la razón principal por la que supera al predeterminado de prioridad de consistencia para pósters. Límite de 1 concurrente — serializa lotes (--concurrency 1), nunca lances generaciones de pósters en paralelo en este modelo.
  • Alternativa — google/gemini-3-pro-image-preview. ~½ la latencia y más barato, tolera ≥4 concurrentes, pero difumina la tipografía pequeña incrustada (autopsia de flipper; confirmado de nuevo en loud-kids-poster-001 — el texto del cuerpo de 4 líneas se volvió suave). Úsalo solo para exploración rápida de paleta/composición, luego finaliza la variante elegida en gpt-image.

Relación de aspecto — resuelta, usa --size

gpt-5.4-image-2 históricamente devolvía 1024² independientemente de --size. A partir de la sesión loud-kids-poster-001, ralphy generate image reenvía image_config.aspect_ratio (derivado de --size) a OpenRouter, y gpt-image lo respeta: --size 1080x1920 → un retrato 9:16 real (cubo nativo de 720×1280). Pasa --size 1080x1920 para un póster de aterrizaje vertical, --size 1080x1080 para una publicación social cuadrada. La salida cae en el cubo nativo más cercano del modelo, no en píxeles exactos: rellena/escala aguas abajo si necesitas un marco exacto.

Modos de fallo

  • Generaciones paralelas de gpt-image → 403 "Key limit exceeded". Serializa (el límite de 1 concurrente). Cada generación también toma ~2.5-4 min.
  • Gemini difumina el texto del cuerpo + la franja del pie de página. No finalices un póster con mucho texto en gemini.
  • El glifo deriva hacia una marca registrada real (marcas smiley, etc.) si no dices "original, NO cualquier marca existente" — incluye siempre esa cláusula.
  • Demasiadas pegatinas → el ojo no tiene dónde descansar. Límite de 3, mantenlas en los bordes del héroe.
  • Marca de palabras + titular del mismo color que un fondo ocupado → la legibilidad muere. El acento de la marca de palabras debe contrastar fuertemente con el degradado.

Ejemplo validado (validado 2026-05-27)

.ralphy/workspaces/<ws>/projects/loud-kids-poster-001/ contiene tres variantes de paleta/héroe/producto construidas sobre este mismo andamio (BOOM/azul real+ piruleta, DANG/coral-ciruela+paleta, YIKES/lima-bosque+gaseosa) más un A/B 9:16 (gpt-image vs gemini). Los tres archivos de prompt (prompt-v1-boom.txt …) son la referencia canónica de ranuras llenas: lee uno antes de redactar un nuevo prompt de póster.

Recetario CLI

# Póster predeterminado, vertical 9:16, tipografía nítida
ralphy generate image --project <id> --slot poster-01 \
  --model openai/gpt-5.4-image-2 --size 1080x1920 --prompt "<andamio lleno>"

# Exploración rápida de paleta/composición (finaliza el ganador en gpt-image después)
ralphy generate image --project <id> --slot poster-explore --variants 3 \
  --model google/gemini-3-pro-image-preview --size 1080x1920 --prompt "<...>"

# Recorte cuadrado para red social del mismo póster
ralphy generate image --project <id> --slot poster-01-sq \
  --model openai/gpt-5.4-image-2 --size 1080x1080 --prompt "<andamio lleno>"

Prompts largos: escribe el andamio lleno en un .txt en el directorio del proyecto y pasa --prompt "$(cat archivo.txt)" — los apóstrofes en el texto del cuerpo rompen las cadenas de shell entre comillas 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.

Skills relacionados