Communitygithub.com

alecs5am/ralphy

Comment créer une affiche de marque vivante et pleine de caractère — une image fixe unique, pas une vidéo. Un surcouche généralisée sur l'étape de direction artistique : fournit l'architecture d'une affiche-page-d'accueil, le jeu de paramètres, la pile de modèles et les modes d'échec du créneau. Fonctionne pour N'IMPORTE QUELLE marque et N'IMPORTE QUELLE esthétique nommée par l'utilisateur.

Qu'est-ce que ralphy ?

Ce skill, `alecs5am/ralphy`, est un surcouche de création de contenu niché et généralisé pour produire des affiches statiques (posters, flyers, key art, images de teasing merch) à partir d'une brève utilisateur. Il ne contient pas de contenu finalisé, mais fournit une **architecture fixe** de conception : bandeau supérieur, énorme mot-symbole biseauté, portrait poitrine-haut, collage d'autocollants vinyle, bloc de copie, et fine bande de pied de page. L'utilisateur ne fournit que les **paramètres** : marque, mot d'exclamation, héros, produit, palette (hexadécimaux), glyphe blob original, et registre esthétique. L'avantage principal est sa **politique typographique** : il utilise `openai/gpt-5.4-image-2` par défaut pour une typographie nette et évite ainsi l'un des échecs classiques des affiches (mot-symbole flou). En cas de besoin, il peut basculer sur `google/gemini-3-pro-image-preview` pour une exploration plus rapide. Le skill s'intègre à `ralphy generate image` et impose des invariants stricts : passage obligatoire par cette commande, contrôle de qualité (deux échecs `scoreImage` consécutifs → arrêt), vérification de l'authenticité des marques réelles par un sous-agent Playwright avant toute génération, et respect strict des schémas de conception. Il est adapté pour toute marque et esthétique nommée par l'utilisateur (Y2K, vaporwave, grunge, DTC propre), et s'active sur des requêtes génériques du type « fais une affiche pour [marque] ».

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Déclencheur

SE DÉCLENCHE sur une demande d'image statique générique : "fais une affiche pour ", "affiche de lancement", "affiche-page-d'accueil", "flyer", "key art", "image de teasing", "image style pochette d'album", "image d'annonce de drop merchandising". N'importe quel sujet, n'importe quelle esthétique — le skill n'est pas lié à un sujet ou un style spécifique.

NE PAS DÉCLENCHER lorsque :

  • L'utilisateur désigne une affiche spécifique à reproduire (@template:<slug>, "remixe celle-ci", donne un slug) → c'est le chemin remix. Voir docs/skills-vs-templates.md.
  • L'utilisateur veut une vidéo animée (le mot-symbole anime, le héros parle) → sélectionner le format vidéo / le modèle, charger le skill de surcouche vidéo correspondant (ugc-*), et utiliser le playbook de l'éditeur, pas ce skill.
  • L'utilisateur a collé @guideline:<slug> pour un registre dans lequel s'inscrit cette affiche (humains photoréalistes, anti-AI-slop) → exécuter ralphy guideline show <slug> en premier et intégrer ses règles dans le slot de la photo du héros.

Ce qu'est ce skill

Un surcouche de mise en page généralisée, pas une affiche finie. Il ne nomme ni une marque, ni un héros, ni une palette — il indique au directeur artistique COMMENT cette classe d'affiche est construite afin qu'une affiche solide sorte pour tout ce que l'utilisateur promeut. Il s'exécute via ralphy generate image ; il ne contourne pas le portail d'exigence de référence ni le portail de qualité.

Invariants stricts

  • Toute génération passe par ralphy generate image (pas d'API brute). Lire MODELS.md avant de nommer un identifiant de modèle — la pile ci-dessous est une valeur par défaut, pas un codage en dur.
  • Le portail d'exigence de référence se déclenche toujours pour une entité réelle nommée dans le slot héros ou produit (une personne réelle, un produit de marque reconnaissable, une propriété intellectuelle). Une marque fictive + un glyphe original + un produit générique peut avancer sans référence. Rendre le glyphe de la marque explicitement ORIGINAL dans le prompt ("PAS une marque existante") pour que le modèle ne dérive pas vers une marque déposée.
  • Le portail de qualité refuse, ne prévient pas — deux scoreImage échoués consécutifs → s'arrêter et signaler les options.
  • Vérification pré-vol pour une marque réelle : ancrage sur le site avant tout prompt. Si l'affiche cible une marque réelle (propre startup de l'utilisateur, site d'un client, toute URL donnée), envoyer un sous-agent Playwright pour explorer la page d'accueil + /docs + /pricing + /features + /examples AVANT de rédiger l'ADN de la marque ou le prompt. Lire artifacts/refs/research.md (le résumé du sous-agent), pas seulement un WebFetch de la page d'accueil. Chaque {{palette}} hex doit provenir de artifacts/refs/tokens.json ; chaque symbole d'API nommé dans le corps du texte ou les slots créatifs de code doit provenir de "Surfaces d'API documentées" dans research.md. Discipline complète + modèle de prompt du sous-agent : .agents/skills/researcher/references/site-grounding.md. Ignorer cela a coûté à sotaocr-fb-001 1,20 $ + 5/32 créatifs SDK hallucinés.

Le créneau, en un paragraphe

Une affiche-page-d'accueil repose sur un mot-symbole massif et lisible plus un seul personnage établissant un contact visuel ou quasi-visuel, le tout assemblé par une énergie de collage DIY d'autocollants. Le regard doit se poser sur le mot, puis sur le visage, puis rebondir sur 2-3 accents d'autocollants, puis lire la copie. Une typographie nette est tout l'enjeu — un mot-symbole brouillé le tue instantanément, c'est pourquoi le choix du modèle est axé sur la typographie d'abord, pas sur la cohérence.

L'architecture fixe (ne pas restructurer — seulement remplir les slots)

De haut en bas, chaque affiche de ce créneau conserve cette structure :

BandeRôle fixeSlot(s) à remplir
1. Bandeau supérieurpetite ligne d'introduction en capitales espacées{{tagline}}, couleur d'accent
2. Mot-symbolelettrage énorme, gras, à empattement, ombre biseautée 3D, reflet chromé par lettre, léger tilt ludique + terminaisons imparfaites{{exclamation}} (mot court percutant : BOOM / DANG / YIKES / WOW / OOPS)
3. Photo héros (~60% hauteur)portrait poitrine-haut cinématographique, regard vers le haut, décontracté-cool, glyphe blob original sur la poitrine, produit tenu à hauteur de bouche, lumière douce en contre-jour, grain argentique{{hero}}, {{product}}, {{blob_glyph}}
4. Collage d'autocollants3 autocollants vinyle (fine bordure blanche + ombre portée douce + coin de scotch), disposés à des angles ludiquesétoile avec macro produit · étoile avec visage blob · petite étoile avec étiquette pixel "NOUVEAU DROP"
5. Bloc de copietitre condensé en capitales + 4 lignes en italique à empattement + pilule CTA remplie{{headline}}, {{body_copy}}, {{cta}}
6. Bande de pied de pagetrès fine ligne en capitales espacées sur toute la largeur{{brand}} · EST. AAAA · <slogan de processus> · WWW.<domaine>

Couche de finition (toujours appliquée) : grain argentique subtil + léger vignettage + légère chaleur CRT + effet de sérigraphie vintage.

Slots (les seules choses qui changent entre les affiches)

  • {{brand}} + {{tagline}} + {{domain}} — le label fictif (ou appartenant à l'utilisateur).
  • {{exclamation}} — le mot du mot-symbole. Un seul token court et criable.
  • {{hero}} — personne + tenue + expression. Varier librement l'âge/le genre/le style.
  • {{product}} — l'accessoire tenu à hauteur de bouche (sucette, esquimau, canette de soda, micro, …). Le garder générique/sans marque sauf si l'utilisateur possède la marque.
  • {{palette}} — dégradé de fond pleine page (2 hex) + couleur d'accent (mot-symbole/titre) + couleur d'ombre biseautée + couleur crème du corps + charbon pour les traits + couleur du produit. Toujours donner l'hex exact.
  • {{blob_glyph}} — une créature amicale dessinée à la main ORIGINALE (blob souriant, nuage cyclope, étoile bancale). Le mot de la marque écrit à l'intérieur en minuscules. Indiquer "PAS une marque existante".
  • {{aesthetic}} — le registre (Y2K surf-skate streetwear est la valeur par défaut validée ; vaporwave, grunge zine, DTC propre, arcade-90s fonctionnent tous sur la même structure).

Pile de modèles (vérifier avec MODELS.md à chaque exécution)

  • Par défaut — openai/gpt-5.4-image-2. Typographie premium / précision des étiquettes : le mot-symbole biseauté, la fine bande de pied de page et les 4 lignes de corps de texte se lisent tous nettement. C'est la raison pour laquelle il bat le modèle par défaut axé sur la cohérence pour les affiches. Limité à 1 concurrent — sérialiser les lots (--concurrency 1), ne jamais lancer de générations d'affiches en parallèle sur ce modèle.
  • De secours — google/gemini-3-pro-image-preview. ~2× moins de latence et moins cher, supporte ≥4 concurrents, mais brouille les petites typographies intégrées (postmortem flipper ; confirmé à nouveau sur loud-kids-poster-001 — les 4 lignes de corps de texte sont devenues floues). Utiliser uniquement pour une exploration rapide de palette/composition, puis finaliser la variante choisie sur gpt-image.

Ratio d'aspect — résolu, utiliser --size

gpt-5.4-image-2 renvoyait historiquement 1024² indépendamment de --size. Depuis la session loud-kids-poster-001, ralphy generate image transmet image_config.aspect_ratio (dérivé de --size) à OpenRouter, et gpt-image le respecte : --size 1080x1920 → un vrai portrait 9:16 (bucket natif 720×1280). Passer --size 1080x1920 pour une affiche verticale page d'accueil, --size 1080x1080 pour un post social carré. La sortie atterrit sur le bucket natif le plus proche du modèle, pas au pixel près — compléter/mettre à l'échelle en aval si vous avez besoin d'un cadre exact.

Modes d'échec

  • Générations gpt-image parallèles → 403 "Key limit exceeded". Sérialiser (la limite de 1 concurrent). Chaque génération prend également ~2,5-4 min.
  • Gemini brouille le corps de texte + la bande de pied de page. Ne pas finaliser une affiche riche en typographie sur gemini.
  • Le glyphe dérive vers une marque déposée réelle (marques smiley, etc.) si vous ne dites pas "original, PAS une marque existante" — toujours inclure cette clause.
  • Trop d'autocollants → l'œil n'a nulle part où se reposer. Limiter à 3, les garder sur les bords du héros.
  • Mot-symbole + titre de la même couleur qu'un fond chargé → la lisibilité meurt. L'accent du mot-symbole doit fortement contraster avec le dégradé.

Exemple validé (validé le 2026-05-27)

.ralphy/workspaces/<ws>/projects/loud-kids-poster-001/ contient trois variantes de palette/héros/produit construites sur cette structure exacte (BOOM/bleu-royal+sucette, DANG/corail-prune+esquimau, YIKES/vert-citronné+soda) plus un A/B 9:16 (gpt-image vs gemini). Les trois fichiers de prompt (prompt-v1-boom.txt …) sont la référence canonique des slots remplis — en lire un avant de rédiger un prompt de nouvelle affiche.

Aide-mémoire CLI

# Affiche par défaut, verticale 9:16, typographie nette
ralphy generate image --project <id> --slot poster-01 \
  --model openai/gpt-5.4-image-2 --size 1080x1920 --prompt "<structure remplie>"

# Exploration rapide de palette/composition (finaliser le gagnant sur gpt-image après)
ralphy generate image --project <id> --slot poster-explore --variants 3 \
  --model google/gemini-3-pro-image-preview --size 1080x1920 --prompt "<...>"

# Recadrage carré pour post social de la même affiche
ralphy generate image --project <id> --slot poster-01-sq \
  --model openai/gpt-5.4-image-2 --size 1080x1080 --prompt "<structure remplie>"

Prompts longs : écrire la structure remplie dans un .txt dans le répertoire du projet et passer --prompt "$(cat file.txt)" — les apostrophes dans le corps du texte cassent les chaînes shell entre guillemets simples en ligne.

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 associés