Communitygithub.com

alecs5am/ralphy

Pipeline completo de extracción → clasificación → plano → deduplicación → publicación para un proyecto `.ralphy/workspaces/<ws>/projects/<id>/` finalizado. Lee `units/*/unit.json` (#069) como fuente de verdad de la unidad y divide el proyecto en las CINCO entidades — Unidad + los cuatro bloques tipados: Template (estructura), Style (apariencia), Recipe (efecto/tratamiento) y Asset (medio reutilizable). Aplica la división receta-vs-etiqueta (#082/#083): un candidato es una Receta solo si lleva un artefacto extraíble (ffmpeg filtergraph / HyperFram).

¿Qué es ralphy?

ralphy es una herramienta avanzada de inteligencia artificial diseñada para desarrolladores y usuarios de agentes AI que trabajan con pipelines de procesamiento de medios. Su función principal es tomar un proyecto terminado en el ecosistema `.ralphy`, leer sus unidades desde `units/*/unit.json` y clasificarlas en cinco entidades distintas: Unidad (el elemento base), Template (estructura), Style (apariencia visual), Recipe (efecto o tratamiento aplicable) y Asset (medio reutilizable como videos o imágenes). La herramienta es especialmente útil porque aplica una lógica inteligente para decidir si un elemento es una Receta o una simple etiqueta, basándose en si contiene un artefacto extraíble como un filtro de ffmpeg o un archivo HyperFram. Está optimizada para plataformas como Claude Code, Cursor y Codex, y su pipeline incluye pasos de extracción, clasificación, generación de planos (blueprint), deduplicación y publicación, asegurando que el proyecto esté limpio y listo para su uso en flujos de trabajo de producción de medios. En resumen, ralphy automatiza la organización y publicación de proyectos multimedia complejos, ahorrando tiempo y reduciendo errores manuales.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alecs5am/ralphy/tree/main/.agents/skills/templater

Preguntar en tu IA favorita

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

Documentación

¿Qué hace ralphy?

El pipeline completo de extracción → clasificación → plano → deduplicación → publicación para un proyecto .ralphy/workspaces/<ws>/projects/<id>/ finalizado. Lee sus units/*/unit.json (#069) como fuente de verdad de la Unidad, luego divide el proyecto en las CINCO entidades — Unidad + los cuatro bloques tipados: Template (estructura), Style (apariencia), Recipe (efecto/tratamiento) y Asset (medio reutilizable). Aplica la división receta-vs-etiqueta (#082/#083): un candidato es una Receta solo si lleva un artefacto extraíble (ffmpeg filtergraph / HyperFram).

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

>- 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

>- 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