Communitygithub.com

oyi77/1ai-skills

Convierte texto arbitrario (artículos, notas, temas, resúmenes) en un video explicativo sin rostro usando HyperFrames. Úsalo cuando el usuario quiera una explicación de un tema, desglose de concepto, tutorial o lista, sin necesidad de capturar un producto o sitio web.

¿Qué es 1ai-skills?

Esta skill transforma texto arbitrario en videos explicativos sin rostro (sin presentador en cámara) utilizando HyperFrames. Es ideal para crear explicaciones de conceptos, tutoriales, listas animadas o videos basados en datos (gráficos, estadísticas, comparaciones) a partir de artículos, notas o resúmenes. Cada escena inventa sus propios elementos visuales (tipografía, gráficos abstractos, diagramas, visualizaciones de datos) sin necesidad de capturar una URL. La skill guía al agente a través de un flujo de trabajo completo: iniciar un proyecto HyperFrames, diseñar un sistema visual (paleta, tipografía), crear un storyboard y guion, generar audio con voz sintética (voz predeterminada: Marcia femenina en HeyGen), diseñar secuencias de planos con código de tiempo sincronizadas con la narración, y finalmente renderizar el video MP4. Está diseñada para agentes de IA como Claude Code, Cursor o Codex, que ejecutan los comandos por el usuario para producir un video explicativo profesional.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oyi77/1ai-skills/tree/HEAD/content/hyperframes-faceless-explainer

Preguntar en tu IA favorita

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

Documentación

Resumen

Esta skill crea videos explicativos sin rostro — basados en narración, sin presentador en cámara — como composiciones de HyperFrames. Úsala para explicaciones de productos o conceptos donde la voz en off y los visuales transmiten el mensaje. Renderiza el MP4 final a partir de un guion que proporciones.

HyperFrames — Explicador Sin Rostro

Convierte texto arbitrario en un video explicativo: elige un sistema de diseño, planifica una historia didáctica y constrúyela cuadro por cuadro. Sin rostro significa que cada elemento visual se inventa — no hay paso de captura ni inventario real de activos.

Cuándo Usarlo

  • El usuario quiere una explicación de un tema a partir de un artículo, notas o resumen
  • El usuario quiere un desglose de concepto (cómo funciona algo)
  • El usuario quiere un tutorial o guía práctica (sin captura de pantalla)
  • El usuario quiere una lista animada o lista con viñetas
  • El usuario quiere un explicador basado en datos (gráficos, estadísticas, comparaciones)

Cuándo NO Usarlo

  • El usuario quiere un lanzamiento de producto (usa hyperframes-product-launch-video)
  • El usuario quiere un video con presentador (usa hyperframes-embedded-captions)
  • El usuario quiere un gráfico en movimiento (usa hyperframes-motion-graphics)
  • El usuario quiere capturar un sitio web (usa hyperframes-product-launch-video)

Flujo de Trabajo

0 · Configuración

npx hyperframes init "videos/<proyecto>" --non-interactive --example=blank --skill=faceless-explainer

Escribe BRIEF.md inmediatamente después de init (nunca antes — init rechaza un directorio no vacío). Registra las preferencias con node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes ..

1 · Resumen (sin captura)

Guarda la entrada completa del usuario tal cual:

  • capture/extracted/visible-text.txt — el artículo/notas/tema/resumen completo
  • capture/extracted/tokens.json — { "title": "", "description": "", "colors": [], "fonts": [] }

NO ejecutes npx hyperframes capture — no hay URL. Los visuales sin rostro se inventan más adelante.

2 · Sistema de Diseño

Elige un preset de cuadro cuyo estilo se ajuste al tema, tono y audiencia:

node <SKILL_DIR>/scripts/build-frame.mjs --preset <nombre> --hyperframes .

Esto copia el FRAME.md del preset a frame.md y remezcla los tokens de marca. Un explicador sin rostro normalmente no tiene colores ni fuentes de marca → el script conserva la paleta propia del preset.

3 · Storyboard y Guion

Convierte el texto en un plan didáctico cuadro por cuadro. La secuencia del video proviene del diseño narrativo, no del orden de los párrafos del texto de entrada — reordena, fusiona, omite, comprime.

Escribe STORYBOARD.md y (cuando se necesite narración) SCRIPT.md. Cada cuadro necesita:

  • focal / roles — los elementos visuales inventados (palabra protagonista, nodo de diagrama, serie de datos)
  • blueprint — la forma del plano (de hyperframes-animation/blueprints/)
  • transition_in — cómo entra el cuadro

3.1 · Audio

node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <id-de-voz> &

Voz predeterminada del pipeline: Marcia (femenina) en HeyGen / am_michael en Kokoro. El estado de ánimo de la música de fondo proviene del campo music: del storyboard.

Marcador de silencio canónico: music: none en el bloque YAML superior de STORYBOARD.md Y sin SCRIPT.md = proyecto completamente silencioso.

4 · Diseño Visual de los Cuadros

Para cada cuadro, escribe una secuencia de planos con código de tiempo:

  • Elige el blueprint del cuadro (o compón)
  • Instáncialo con el contenido inventado de ESTE cuadro
  • Marca el ritmo de cada revelación de Escena con la voz en off para que el cuadro se desarrolle durante toda su duración

Indica la disposición y el movimiento en línea por Escena. Añade un bloque ## Dirección de video para todo el video.

5 · Construir los Cuadros

Espera a que termine el audio del paso 3.1. Luego:

node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md
node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"

Despacha un subagente por cuadro. Cada trabajador recibe:

  • _role.md (el rol del trabajador de cuadro)
  • El paquete de ese cuadro (bloque exacto del storyboard + cuerpo del blueprint + recetas de reglas citadas, en línea)

Los trabajadores escriben solo compositions/frames/NN-*.html. Nunca editan STORYBOARD.md.

Los fondos a sangre completa se montan en una capa class="clip", nunca en #root. El suelo de un cuadro es su propio clip de fondo de duración completa.

Construye los subtítulos en segundo plano y ensambla el índice:

node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &
node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .

6 · Finalizar

node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html
npx hyperframes lint
npx hyperframes check
npx hyperframes snapshot --at <puntos-medios-de-los-cuadros>

Renderiza solo después de la aprobación del usuario:

npx hyperframes render --skill=faceless-explainer --quality high --output renders/video.mp4

Tabla Antirracionalización

RacionalizaciónRealidad
"Capturaré el sitio web del artículo"Sin rostro = sin captura. Los visuales se inventan, no se capturan
"Usaré el orden de los párrafos del texto"El diseño narrativo decide la secuencia, no el orden fuente
"Me saltaré el sistema de diseño"frame.md es la fuente de verdad para color/tipo/disposición
"Pondré todo el contenido al principio y luego lo congelaré"Marca el ritmo de las revelaciones con la voz en off — el cuadro se desarrolla durante toda su duración
"Escribiré un solo blueprint y lo reutilizaré"Cada cuadro elige su propio blueprint según el contenido
"Me saltaré el audio y usaré solo texto"El audio es el reloj — todos los tiempos de latido provienen de las marcas de tiempo de las palabras
"Añadiré animaciones de inactividad entre revelaciones"Cada fase actúa — revelaciones escalonadas, cámara con intención o IU secuenciada
"Centraré al 42% para dejar espacio para los subtítulos"Los subtítulos son superposiciones — centra en el centro real (y = H/2)

Verificación

  • hyperframes.json y BRIEF.md existen
  • frame.md existe desde un preset con nombre
  • STORYBOARD.md existe con los campos narrativos requeridos
  • SCRIPT.md existe cuando se necesita narración
  • El trabajo de audio se inició o el proyecto se marcó como silencioso
  • Cada cuadro tiene una secuencia de planos con código de tiempo sincronizada con la voz en off
  • Cada cuadro nombra focal y/o roles inventados
  • index.html existe
  • Los subtítulos se construyeron o se omitieron explícitamente
  • lint y check pasaron antes del renderizado
  • El usuario aprobó en la pausa de revisión

Individual skills in this repo

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

oyi77/1ai-skills

Turn a weekly changelog .md into a finished branded changelog video using HyperFrames. Use when the user provides a changelog/digest markdown and wants the weekly video, or says 'changelog video'. Self-contained — fonts, background, lexicon, and scripts ship in the skill. Produces square 1080, ~45-60s videos with animated brand mock-UIs.

oyi77/1ai-skills

The transition technique catalog for HyperFrames videos — five velocity-matched SEAMS (zoom-through, inverse zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus in-scene techniques (waterfall entry, nudge curve). Covers partial-travel velocity matching, Z scale-sign rule, size-scaled blur, the 10/65/25 slide ratio, and the 2-3 transition budget. Read before authoring any transition, text-beat handoff, or kinetic text entry.

oyi77/1ai-skills

Add captions/subtitles to talking-head or launch videos using HyperFrames. Use when the user wants embedded captions, verbatim caption rails, or cinematic text behind the subject. Covers the drop/rail/embed caption model, the overlay law (captions are NOT a reserved band), matte occlusion for embedded climaxes, and word-timestamp alignment from TTS output.

oyi77/1ai-skills

The fallback HyperFrames workflow for anything that doesn't fit other skills — longer multi-scene pieces, brand/sizzle reels, title cards, static loops, freeform compositions. Input- and length-agnostic. Also the home of companion mode (co-create with the full toolbox). Use when no other HyperFrames skill matches, or when the user wants a freeform video.

oyi77/1ai-skills

Create short, unnarrated, design-led motion graphics (~under 10s) using HyperFrames. Use when the user wants kinetic type, stat/chart hits, logo stings, lower-thirds, animated tweets/headlines, or transparent overlay motion graphics. MP4 or transparent overlay output. Teaches seek-safe keyframe authoring and the 2-3 transition budget rule.

oyi77/1ai-skills

Turn a music track into a beat-synced HyperFrames video — lyric, slideshow, or kinetic promo. Use when the user provides an audio file, a video to pull audio from, or a mood brief for generated music. Music drives pacing. Teaches beat-map extraction, section-based scene planning, and audio-reactive visuals.

oyi77/1ai-skills

Create product launch videos from a URL, brief, or script using HyperFrames (HTML→MP4). Use when the user wants a product launch video, site tour, social clip featuring a product's own visuals, or marketing/promoting a product. Up to ~3 min (sweet spot 30-90s). Teaches the HyperFrames production loop: plan → write HTML → wire seekable animations → add media → lint → preview → render.

oyi77/1ai-skills

The Video Production Manager — manages ALL video production under 1ai-content. Delegates to HyperFrames, Remotion, AI video, and FFmpeg based on the task. Has memory via 1ai-hub brain, follows 1ai-rules, and reports to Content Director. Use when the user says 'make a video', 'create video', 'edit video', 'video strategy', or needs any video production work.

oyi77/1ai-skills

Agent skill at content/video/gen/SKILL.md

oyi77/1ai-skills

Use when track portfolio company KPIs, variances, returns analysis. Use when user says "monitor portfolio", "track KPIs", "portfolio returns".

oyi77/1ai-skills

Use when go-to-market planning — launch sequencing, channel strategy, audience building, PR outreach. Use when planning product launches, building launch checklists, or coordinating multi-channel campaigns.

oyi77/1ai-skills

Use when portfolio manager — capital allocation, risk management, and performance metrics tracking for trading strategies.

Skills relacionados