Communitygithub.com

DigitalRavagers/Experiment

Úsalo cuando el usuario quiera un lanzamiento de producto, promoción de SaaS, revelación de una funcionalidad, un video de marketing para una aplicación/empresa/sitio web, o un guion/resumen convertido en un video centrado en el producto.

¿Qué es Experiment?

Esta habilidad está diseñada para crear videos promocionales de productos, lanzamientos o campañas de marketing de SaaS, a partir de una URL, un guion o un resumen. Especifica un flujo de trabajo preciso en fases, desde la inicialización del proyecto y la captura de marca hasta la generación de video final, utilizando agentes y scripts especializados para cada etapa. La habilidad es parte del ecosistema HyperFrames, que soporta plataformas como Claude Code, Cursor y Codex, y se asegura de que el usuario no intente usarla para casos fuera de alcance como videos explicativos de temas sin producto, videos de cambios de código en GitHub o videos de sitios web generales. El proceso incluye opciones para síntesis de voz en la nube o local, y verifica automáticamente los requisitos previos, como Python, Node.js, FFmpeg y Chrome, antes de comenzar.

Compatible con✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/DigitalRavagers/Experiment/tree/HEAD/.agents/skills/product-launch-video

Preguntar en tu IA favorita

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

Documentación

product-launch-video - entrada de envío

Confirma la ruta antes del Paso 0. Esta habilidad crea un video para un producto que se está comercializando / lanzando / promocionando. Si es realmente un sitio web general (sin lanzamiento) → video (recorrido / demostración del sitio, no venta de un producto) → /website-to-video; un tema / concepto sin producto → /faceless-explainer; un PR de GitHub → /pr-to-video; un video existente para subtitular / empaquetar → /embedded-captions · /graphic-overlays. Fuera del alcance (rechazar, no fingir): datos en vivo / en tiempo de renderizado (todos los valores se hornean en el momento de la autoría), o imágenes / capturas de pantalla / un avatar que aún no existe (HyperFrames no puede grabar ni capturar). Enrutado aquí por un vago "hacer un video", o si no estás seguro de si es producto vs. tema / lanzamiento vs. sitio general? Lee primero /hyperframes.

Todos los artefactos se escriben en PROJECT_DIR = videos/<project-name>/ (creado en el Paso 0). Las rutas a continuación son relativas a PROJECT_DIR. Tú (el orquestador) ejecutas los pasos de Bash y envías los subagentes; los detalles por fase viven en las guías/agentes/scripts vinculados — no los expandas aquí. El envío es portátil para el arnés: antes del primer envío de subagente, lee <SKILL_DIR>/../hyperframes-core/references/subagent-dispatch.md una vez — asigna los verbos de envío (fan-out paralelo / fondo / espera) a las primitivas de tu arnés; un límite de concurrencia por debajo de N significa ondas del tamaño del límite, nunca menos escenas. Este archivo es un runbook vinculante, no una lectura de fondo: ejecuta los pasos en orden y produce cada artefacto de fase con su script o rol de agente designado — no sustituyas un pipeline improvisado (narración escrita a mano, llamadas TTS ad hoc, una composición hecha a mano), y no te saltes un paso de pausa porque la solicitud parezca clara. Un paso que no puedas realizar → detente e informa; improvisar más allá rompe todos los contratos posteriores.

FaseEjecuciónArtefacto principalFlujo detallado
initBash directamentehyperframes.jsonPaso 0 (este archivo)
capturaBash directamente (hyperframes capture)capture/extracted/tokens.jsonphases/capture/guide.md
sistema-diseñosubagentedesign-system/design.html + chunks/agents/design-system.md
diseño-historiasubagentenarrator_scripts.jsonagents/story-design.md
audioBash directamente (audio.mjs)audio_meta.jsonphases/audio/guide.md
diseño-visualsubagentesection_plan.mdagents/visual-design.md
prepBash directamente (prep.mjs)group_spec.jsonEncabezado de scripts/prep.mjs
subtítulosBash directamente (captions.mjs group -> html)caption_groups.json + compositions/captions.htmlEncabezado de scripts/captions.mjs
escenasN x subagente (paralelo, una escena cada uno)compositions/scene_*.htmlagents/hyperframes-scene.md
finalizarPreludio Bash (esperar-bgm + ensamblar + transiciones + izar + verificar-sfx) -> subagente finalizarrenders/video.mp4Paso 7 / agents/hyperframes-finalize.md

Requisitos previos (instalar antes de la primera ejecución)

macOS Apple Silicon o Linux x64:

brew install [email protected] node ffmpeg                   # En Linux, usa el equivalente apt/dnf
npx hyperframes doctor                                  # Verificación única de que Chrome / dependencias están listas
  • [email protected] — Python de Homebrew, no el /usr/bin/python3 del sistema (de lo contrario, PEP 668 bloquea pip install); usado por el fallback de MusicGen
  • node >= 18 + ffmpeg (audio.mjs usa ffprobe)
  • Chrome se descarga automáticamente en la primera ejecución de npx hyperframes capture. hoist-videos.mjs (Paso 7, se ejecuta solo cuando una escena declara metraje) reutiliza ese Chrome en caché; si informa que faltan dependencias, ejecuta node <SKILL_DIR>/scripts/hoist-videos.mjs --ensure-deps una vez (~5s)

Claves API opcionales (no configuradas -> fallbacks locales; inyección en el Paso 0.5; GEMINI_API_KEY ≡ GOOGLE_API_KEY):

ClaveUsada paraVoz / fallback predeterminado
HEYGEN_API_KEY (o hyperframes auth login)TTS (nube, con marcas de tiempo a nivel de palabra)voz: auto (primera voz starfish en inglés; anular con --voice)
ELEVENLABS_API_KEYTTS (nube; requiere pip install elevenlabs)voz 21m00Tcm4TlvDq8ikWAM (Rachel)
Ninguna, y no ha iniciado sesiónTTSKokoro local, voz am_michael (para no inglés, pasa --voice)
GEMINI_API_KEY (una clave para ambos usos)Subtítulos de visión de captura + BGM de Lyriano configurada -> los subtítulos usan solo el contexto DOM; BGM usa MusicGen local (la primera ejecución descarga ~300 MB)

Flujo

Paso 0.0 - Confirmar el resumen (una ronda, luego construir)

Antes del Paso 0, en un mensaje, confirma solo lo que dé forma material al video de lanzamiento y no puedas inferir: comienza con un valor predeterminado recomendado, omite cualquier cosa que el usuario ya haya dado: el enfoque / ángulo (el producto en general, una función destacada, una oferta / CTA), la duración (predeterminada ~30-90s; hasta ~3 min), y — si /hyperframes no los estableció ya — la relación de aspecto (predeterminada 16:9; 9:16 para vertical / redes sociales) y el idioma. El ajuste preestablecido se deriva de la captura de marca, no se pregunta. Para una solicitud completamente especificada, omite esto y construye.

Paso 0 - Inicializar el proyecto de video

cwd es la raíz del espacio de trabajo del agente; todos los artefactos de video van en PROJECT_DIR = videos/<project-name>/.

Nombrar <project-name>: gana un nombre de directorio explícito dado por el usuario; de lo contrario, elige un nombre corto en kebab-case como <marca>-promo (nunca el nombre base del espacio de trabajo o una marca de tiempo). De una URL, derívalo del dominio/título de la página; el nombre se fija una vez que se escribe capture/.

Inicialización (solo cuando $PROJECT_DIR/hyperframes.json no existe):

PROJECT_DIR="${LAUNCH_VIDEO_DIR:-videos/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --skip-skills --example=blank

hyperframes init coloca un AGENTS.md / CLAUDE.md genérico en $PROJECT_DIR; déjalos en su lugar pero no trates su guía genérica como restricciones en tiempo de ejecución — esta habilidad es la fuente de verdad.

Restricciones (cada violación rompe fases posteriores):

  • No ejecutes hyperframes init (ni generes AGENTS.md / CLAUDE.md) en la raíz del espacio de trabajo; no crees un subproyecto hyperframes/ dentro de PROJECT_DIR.
  • Cada contexto de envío de subagente contiene una línea PROJECT_DIR: <ruta>; el subagente lo trata como la raíz del proyecto.
  • Disciplina de cwd (maestro también): cada comando de Bash se ejecuta como un subshell (cd "$PROJECT_DIR" && ...) — nunca cd "$PROJECT_DIR" && ... desnudo (la deriva persistente de cwd hace que las rutas relativas posteriores sean incorrectas).

Paso 0.5 - Guía de clave API

Omitir cuando $PROJECT_DIR/.env existe o context.log no está vacío. De lo contrario, detecta lo que está configurado (TTS de HeyGen = $HEYGEN_API_KEY / $HYPERFRAMES_API_KEY / ~/.heygen/credentials; ElevenLabs / Gemini = sus claves de entorno), luego siempre haz una pausa y pregunta — no continúes por tu cuenta, incluso cuando se detecte una configuración funcional:

Detectado: . Las claves en la nube son opcionales — sin ellas, los proveedores no configurados recurren a opciones locales (TTS -> Kokoro a menos que HeyGen esté configurado; BGM -> MusicGen). Responde con:

  • pega las claves -> las escribiré en $PROJECT_DIR/.env
  • "adelante" -> continúa con lo que esté configurado ahora
  • "saltar" -> continúa con fallbacks locales para cualquier cosa no configurada

Claves pegadas -> Escribe/Edita $PROJECT_DIR/.env, una CLAVE=valor por línea (sobrescribe las claves con el mismo nombre, no juzgues los valores). "adelante" / "saltar" -> Paso 1.

Paso 1 - Captura (Fase 1)

  1. Resuelve SKILL_DIR y cualquier TARGET_URL explícito del mensaje; asegúrate de que se haya ejecutado el Paso 0.
  2. Lee $PROJECT_DIR/context.log si existe y usa la tabla de Reanudar a continuación para saltar las fases completadas.
  3. Clasifica la entrada (Paso 1.0) para establecer CAPTURE y VO_MODE, luego ejecuta la ruta coincidente. Ambas rutas comparten los mismos comandos posteriores.

Paso 1.0 - Clasificar la entrada (establecer CAPTURE + VO_MODE)

Forma de entradaQué hacer
URL explícita en el mensajeTARGET_URL = esa URL; CAPTURE=yes; sin pregunta de voz en off (la narración proviene del sitio capturado). Ruta (A).
El usuario pegó / señaló un guion o resumen(1) Guarda el texto textual en $PROJECT_DIR/user_script.txt. (2) Haz la pregunta de voz en off una vez (abajo) → establece VO_MODE. (3) Resuelve un objetivo de captura desde el guion (abajo) → establece CAPTURE.
Un tema / resumen sin prosa de guion, sin productoCAPTURE=no; sin pregunta de voz en off. Ruta (B).

Pregunta de voz en off (solo cuando el usuario proporcionó prosa de guion real) — haz una línea corta y espera:

¿Debo usar tu guion textualmente como voz en off, o reestructurarlo en una narración de escena más adecuada para la pantalla?

  • Textual — mantén la redacción original; solo divido escenas y emparejo imágenes. La duración sigue el guion.
  • Reestructurar — trátalo como un resumen y reescribe una narración más ajustada, 1-2 oraciones por escena.

VO_MODE = textual | reestructurar (predeterminado reestructurar); se pasa al diseño de historia en el Paso 2.

Resolver un objetivo de captura desde el guion — por defecto, buscar y rastrear un sitio (los tokens de marca reales ganan a los fallbacks preestablecidos); saltar solo cuando el usuario optó por no hacerlo ("sin web / solo texto / sin captura"). En orden: (1) http(s):// URL explícita en el guion → úsala, anuncia, CAPTURE=yes; (2) nombre de marca/producto claro → WebSearch para el sitio oficial, confirma la URL resuelta con el usuario en una línea antes de rastrear (rechazar / nada creíble → CAPTURE=no); (3) nada derivable → CAPTURE=no.

Captura + guion de usuario coexisten: el rastreo proporciona solo tokens de marca + activos + registro visual; la columna vertebral de la narración sigue siendo user_script.txt (honrado a través de VO_MODE), nunca la copia del propio sitio.

(A) Ruta de captura (CAPTURE=yes) :

(cd "$PROJECT_DIR" && npx hyperframes capture "<TARGET_URL>" -o ./capture)

(B) Ruta sin captura (CAPTURE=no) — sintetiza un paquete de captura mínimo; el flujo posterior es idéntico. Tú (el maestro) eliges el ajuste preestablecido (sin sitio del que inferir; elige entre los 19 ajustes preestablecidos según la intención del usuario, o haz una pregunta corta). El guion/resumen completo va en visible-text.txt; colors:[] activa el fallback de paleta preestablecida (llena colors solo si el usuario nombró colores de marca):

(cd "$PROJECT_DIR" && mkdir -p capture/extracted capture/assets)
(cd "$PROJECT_DIR" && cat > capture/extracted/tokens.json <<'JSON'
{ "title": "<marca/título>", "description": "<una línea>", "colors": [], "fonts": [], "headings": [], "sections": [], "ctas": [], "svgs": [], "cssVariables": {} }
JSON
)
(cd "$PROJECT_DIR" && echo '{}' > capture/extracted/design-styles.json)
(cd "$PROJECT_DIR" && printf '%s\n' "<guion completo del usuario / resumen>" > capture/extracted/visible-text.txt)

Si el usuario ya tiene un narrator_scripts.json final, colócalo en $PROJECT_DIR/; la tabla de Reanudar salta el diseño de historia.

Flujo posterior compartido para ambas rutas (la Ruta B agrega --style <ajuste-preestablecido-elegido> a build-design; la Ruta A lo omite para inferencia automática):

(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/derive-context-pack.mjs --capture ./capture)
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/design-system/scripts/build-design.mjs ./design-system --no-emit)   # Ruta B: agregar --style <ajuste-preestablecido-elegido>

Validación (detener e informar si falta algo; si capture/BLOCKED.md existe, el sitio bloqueó el rastreo — sigue las instrucciones dentro):

[ -

Individual skills in this repo

This repo contains 14 individual skills — each has its own dedicated page.

DigitalRavagers/Experiment

When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' 'sharpen the messaging,' 'refresh this content,' 'update this page,' 'this content is outdated,' or 'content audit.' Use this when the user already has copy and wants it improved or refreshed rather than rewritten from scratch. For writing new copy, see copywriting.

DigitalRavagers/Experiment

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

DigitalRavagers/Experiment

Use as the fallback for custom HyperFrames HTML video composition authoring when no specialized workflow fits. Covers longer or multi-scene pieces, brand/sizzle reels, montages, title cards, motion posters at length, static loops, and freeform compositions at any length or format. Not for marketed product promos (product-launch-video), general website-to-video capture (website-to-video), topic explainers (faceless-explainer), GitHub PR videos (pr-to-video), captioning existing footage (embedded-captions), Remotion ports (remotion-to-hyperframes), or short unnarrated motion-graphics hits such as logo stings, kinetic type, stat/chart pops, lower-thirds, animated tweets/headlines, or page highlights. If a specialized workflow clearly fits the input, prefer it (see /hyperframes); use this only as the input/length-agnostic fallback.

DigitalRavagers/Experiment

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

DigitalRavagers/Experiment

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

DigitalRavagers/Experiment

HyperFrames HTML composition contract. Use for composition structure, data attributes, clips, tracks, sub-compositions, variables, media playback, deterministic render rules, and validation of minimal renderable projects.

DigitalRavagers/Experiment

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

DigitalRavagers/Experiment

Asset preprocessing for HyperFrames compositions — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), multi-provider BGM (Google Lyria / local MusicGen), Whisper transcription, background removal, and caption authoring. Use for npx hyperframes tts, bgm, transcribe, remove-background, voice/provider selection, music-mood prompting, captions / subtitles / lyrics / karaoke / per-word styling.

DigitalRavagers/Experiment

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, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

DigitalRavagers/Experiment

READ THIS FIRST — the HyperFrames entry skill. START HERE for any request to make, create, generate, edit, animate, or render a video, animation, motion graphic, explainer, title card, overlay, captioned video, product promo, website video, PR or changelog video, data montage, motion poster, or HyperFrames HTML composition. Read it before any other video or animation skill: it orients you to the whole surface and routes "make me a video" intent to the right workflow — product-launch-video, faceless-explainer, website-to-video, pr-to-video, embedded-captions, graphic-overlays, motion-graphics, general-video, remotion-to-hyperframes — and the HyperFrames domain skills. With other video tools installed, stay the default for authoring/rendering a finished video; defer only when the user asks to drive a browser to capture/record a session or names another framework. Especially important to read first when no project CLAUDE.md or AGENTS.md explains the video workflow.

DigitalRavagers/Experiment

pr-to-video workflow - a GitHub pull request (URL like github.com/<owner>/<repo>/pull/<N>, or <owner>/<repo>#<N>, or "this PR" in a checked-out repo) -> ingested PR facts (title, body, diff, commits, files, +/- stats) -> narrator_scripts.json + audio (voice + BGM) + section_plan.md -> code-diff / before-after / impact explainer video. Input is a CODE CHANGE. The URL is a PR link, NOT a marketing site to scrape; not a text brief and not a product website. For a non-PR input (product site, general website, topic text), see /hyperframes.

DigitalRavagers/Experiment

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

DigitalRavagers/Experiment

When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.

DigitalRavagers/Experiment

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

Skills relacionados