Communitygithub.com

alecs5am/ralphy

Boucle de développement CLI HyperFrames — `npx hyperframes` pour l'échafaudage (init), la validation (lint, inspect), l'aperçu, le rendu et le dépannage de l'environnement (doctor, browser, info, upgrade). Utilisez cette compétence lors de l'exécution de ces commandes ou du dépannage de l'environnement de construction/rendu HyperFrames. Pour les commandes de prétraitement d'actifs (`tts`, `transcribe`, `remove-background`), invoquez plutôt la compétence `hyperframes-media`.

Qu'est-ce que ralphy ?

La compétence `ralphy` centralise l'interface en ligne de commande HyperFrames, en fournissant un cycle de développement complet via `npx hyperframes`. Elle permet d'initialiser un projet (`init`), de linter et d'inspecter visuellement les compositions (`lint`, `inspect`), de prévisualiser avec rechargement à chaud (`preview`), de rendre en MP4 ou WebM avec des paramètres de qualité et de parallélisation (`render`), et de diagnostiquer l'environnement (`doctor`, `browser`, `info`, `upgrade`). L'étape `inspect` détecte les débordements de texte et les erreurs de mise en page, tandis que `lint` vérifie les IDs manquants et les pistes qui se chevauchent. Le rendu supporte la surcharge de variables via `--variables`, et le mode Docker garantit des sorties reproductibles. Les commandes de prétraitement d'actifs (TTS, transcription, suppression d'arrière-plan) sont déléguées à la compétence `hyperframes-media`. La compétence est conçue pour fonctionner avec Node.js >= 22 et FFmpeg, et s'intègre aux workflows d'agents IA comme Claude Code ou Cursor.

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

Demander à votre IA préférée

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

Documentation

CLI HyperFrames

Tout s'exécute via npx hyperframes. Nécessite Node.js >= 22 et FFmpeg.

Workflow

  1. Échafaudage — npx hyperframes init my-video
  2. Écrire — composer du HTML (voir la compétence hyperframes)
  3. Linter — npx hyperframes lint
  4. Inspection visuelle — npx hyperframes inspect
  5. Aperçu — npx hyperframes preview
  6. Rendu — npx hyperframes render

Linter et inspecter avant l'aperçu. lint détecte les data-composition-id manquants, les pistes qui se chevauchent et les timelines non enregistrées. inspect ouvre la composition rendue dans Chrome sans tête, parcourt la timeline et signale le texte qui déborde des bulles/conteneurs ou du canevas.

Échafaudage

npx hyperframes init my-video                        # assistant interactif
npx hyperframes init my-video --example warm-grain   # choisir un exemple
npx hyperframes init my-video --video clip.mp4        # avec fichier vidéo
npx hyperframes init my-video --audio track.mp3       # avec fichier audio
npx hyperframes init my-video --example blank --tailwind # avec Tailwind v4 runtime navigateur
npx hyperframes init my-video --non-interactive       # ignorer les invites (CI/agents)

Modèles : blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph.

init crée la structure de fichiers appropriée, copie les médias, transcrit l'audio avec Whisper et installe les compétences de codage IA. Utilisez-le plutôt que de créer des fichiers manuellement.

Lors de l'utilisation de --tailwind, invoquez la compétence tailwind avant de modifier les classes ou les jetons de thème. L'échafaudage utilise Tailwind v4.2 via le runtime navigateur, pas la configuration Tailwind v3 de Studio.

Linting

npx hyperframes lint                  # répertoire courant
npx hyperframes lint ./my-project     # projet spécifique
npx hyperframes lint --verbose        # résultats informatifs
npx hyperframes lint --json           # lisible par machine

Analyse index.html et tous les fichiers dans compositions/. Signale les erreurs (à corriger), les avertissements (à considérer) et les informations (avec --verbose).

Inspection visuelle

npx hyperframes inspect                 # inspecte la disposition rendue sur la timeline
npx hyperframes inspect ./my-project    # projet spécifique
npx hyperframes inspect --json          # résultats lisibles par agent
npx hyperframes inspect --samples 15    # balayage de timeline plus dense
npx hyperframes inspect --at 1.5,4,7.25 # horodatages héroïques explicites

À utiliser après lint et validate, en particulier pour les compositions avec bulles de parole, cartes, légendes ou typographie serrée. Signale :

  • Texte s'étendant à l'extérieur du conteneur visuel ou de la bulle le plus proche
  • Texte coupé par sa propre boîte à largeur/hauteur fixe
  • Texte s'étendant en dehors du canevas de la composition
  • Enfants s'échappant des conteneurs de découpe

Les erreurs doivent être corrigées avant le rendu. Les avertissements sont remontés pour examen par l'agent ; ajoutez --strict pour échouer également sur les avertissements. Les problèmes statiques répétés sont réduits par défaut afin que la sortie JSON reste compacte pour les fenêtres de contexte LLM. Si un débordement est intentionnel pour une animation d'entrée/sortie, marquez l'élément ou l'ancêtre avec data-layout-allow-overflow. Si un élément décoratif ne doit jamais être audité, marquez-le avec data-layout-ignore.

npx hyperframes layout reste disponible comme alias de compatibilité pour la même passe d'inspection visuelle.

Aperçu

npx hyperframes preview                   # sert le répertoire courant
npx hyperframes preview --port 4567       # port personnalisé (défaut 3002)

Rechargement à chaud lors des modifications de fichiers. Ouvre automatiquement le studio dans votre navigateur.

Lorsque vous remettez un projet à l'utilisateur, utilisez l'URL du projet Studio, pas le chemin source index.html :

http://localhost:<port>/#project/<nom-du-projet>

Utilisez le port réel de la sortie d'aperçu et le nom du répertoire du projet. Par exemple, après npx hyperframes preview --port 3017 dans codex-openai-video, signalez http://localhost:3017/#project/codex-openai-video.

Traitez index.html uniquement comme contexte de code source. Il est acceptable de le lier comme fichier d'implémentation, mais ne le qualifiez pas de projet ou de surface d'aperçu.

Rendu

npx hyperframes render                                # MP4 standard
npx hyperframes render --output final.mp4             # sortie nommée
npx hyperframes render --quality draft                # itération rapide
npx hyperframes render --fps 60 --quality high        # livraison finale
npx hyperframes render --format webm                  # WebM transparent
npx hyperframes render --docker                       # identique octet par octet
DrapeauOptionsDéfautRemarques
--outputcheminrenders/nom_timestamp.mp4Chemin de sortie
--fps24, 30, 603060fps double le temps de rendu
--qualitydraft, standard, highstandarddraft pour itérer
--formatmp4, webmmp4WebM supporte la transparence
--workers1-8 ou autoautoChaque spawn Chrome
--dockerdrapeaudésactivéSortie reproductible
--gpudrapeaudésactivéEncodage accéléré par GPU
--strictdrapeaudésactivéÉchouer sur les erreurs de lint
--strict-alldrapeaudésactivéÉchouer sur les erreurs ET les avertissements
--variablesobjet JSON—Remplacer les valeurs de variables déclarées dans data-composition-variables
--variables-filechemin—Fichier JSON avec valeurs de variables (alternative à --variables)
--strict-variablesdrapeaudésactivéÉchouer le rendu sur les clés non déclarées ou les types incompatibles dans --variables

Conseil de qualité : draft pour itérer, standard pour la révision, high pour la livraison finale.

Rendus paramétrés : la composition déclare ses variables sur la racine <html> avec data-composition-variables — un tableau JSON de déclarations ({id, type, label, default} par entrée) qui définit le schéma. Les scripts internes lisent les valeurs résolues via window.__hyperframes.getVariables(). La CLI **`--variables '{

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

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

>- How to make a vivid, character-driven brand POSTER — a single still image, not a video. A generalized overlay on the art-director step: supplies the poster-as-landing architecture (top banner → massive beveled wordmark → chest-up hero photo → scattered vinyl-sticker collage → copy block → thin footer strip), the parameterized slot set (brand, exclamation word, hero, product, palette, original blob glyph, aesthetic register), the model stack (gpt-5.4-image-2 for crisp typography, gemini fallback), and the niche's failure modes. Works for ANY brand and ANY aesthetic the user names — Y2K streetwear, vaporwave, grunge zine, clean DTC — the skill supplies the layout know-how, the user supplies the subject + vibe. USE WHEN the user asks for a poster / flyer / drop poster / "poster-as-landing-page" / brand key-art / album-cover-style still / hype graphic, with no specific existing poster to reproduce. This is a content-niche craft-overlay SKILL (generalized), loaded on top of a poster-format template match — n...

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