Communitygithub.com

oiyi77/1ai-skills

Convierte un changelog semanal en .md en un video de changelog animado y con marca, usando HyperFrames. Se activa cuando el usuario proporciona un changelog/resumen markdown y quiere el video semanal, o dice 'video de changelog'. Autocontenido: incluye fuentes, fondo, léxico y scripts. Produce videos cuadrados en 1080p, de aproximadamente 45-60 segundos, con interfaces de marca animadas.

¿Qué es 1ai-skills?

Esta skill transforma un changelog de lanzamiento en un video pulido y con marca, utilizando el renderizado HTML de HyperFrames. Es ideal para cuando una actualización de producto merece un anuncio visual: incluye fotogramas destacados, viñetas clave y un patrón de fondo. El resultado es un video MP4 renderizado a partir de las entradas del changelog que se le proporcionen. La skill sigue un flujo de trabajo riguroso: primero, se copian los activos de fuente, música de fondo y patrón de fondo desde los assets de la skill. Luego, se analiza el changelog, se aplica un corte editorial para ajustarse a un presupuesto de 45-60 segundos, y se enruta cada tema a una visualización mediante un registro de visualizaciones. Se genera un guion de dos capas (hablado y mostrado), se sincronizan las marcas de tiempo de las palabras con la locución, y se construye el proyecto siguiendo las especificaciones de marca. Es compatible con plataformas que ejecuten HyperFrames y Node.js, y está diseñada para ser autocontenida: las fuentes, el fondo animado, el léxico de pronunciación y los scripts se incluyen en la skill. Es especialmente útil para equipos de producto que quieren comunicar cambios de forma visual y atractiva, evitando listas aburridas de viñetas. El proceso incluye varias verificaciones obligatorias: `hyperframes check` y `seam-gate.mjs verify` deben pasar sin errores, la barra de subtítulos debe ser visible en al menos 3 fotogramas, y las marcas de tiempo de las palabras deben alinearse con el audio. La skill solo renderiza el video final cuando el usuario lo solicita explícitamente.

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

Preguntar en tu IA favorita

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

Documentación

Visión general

Esta skill convierte un changelog de lanzamiento en una composición de video pulida usando el renderizado HTML de HyperFrames. Úsala cuando una actualización de producto merezca un anuncio visual: fotogramas destacados, viñetas clave y un patrón de fondo. Produce un MP4 renderizado a partir de las entradas del changelog que le proporciones.

HyperFrames — Video de Changelog

Entrada: un changelog en .md (temas + elementos). Salida: un proyecto HyperFrames limpio y con el sello 'seam-gate-green'. Renderiza solo cuando se te pida.

Cuándo Usarla

  • El usuario proporciona un changelog/resumen markdown y quiere el video semanal
  • El usuario dice "video de changelog" o "video del resumen semanal"
  • El usuario quiere un video con marca que incluya interfaces de usuario animadas y locución

Cuándo NO Usarla

  • El usuario quiere un lanzamiento de producto (usa hyperframes-product-launch-video)
  • El usuario quiere un gráfico en movimiento (usa hyperframes-motion-graphics)
  • El usuario quiere un video de una persona hablando (usa hyperframes-embedded-captions)

La Directriz Principal: Visualizar, No Listar

Cada tema se ilustra mediante una interfaz de usuario animada que representa el cambio real o un análogo fiel, actuando la evolución de la experiencia — nunca con viñetas de texto. Enruta cada tema/elemento a través del registro de visualizaciones ANTES de escribir el guion.

Flujo de Trabajo

0 · Inicializar desde los assets de la skill (no negociable)

mkdir -p project/assets/fonts
cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/
cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3
ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
  -vf "scale=1080:1080,fps=30,eq=saturation=0.72,[email protected]:t=fill" \
  -an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4
cp <SKILL_DIR>/examples/master-skeleton.html project/index.html

Luego, lee references/build-spec.md de principio a fin: allí se definen los tokens de marca.

1 · Análisis + corte editorial

  • Extrae: rango de semana, estadísticas destacadas, temas, elementos
  • Presupuesto: 45-60s en total. Título ≤2s, cierre ≤3.5s, 4 temas ≈ 9-12s cada uno
  • Por tema, mantén UNA visualización destacada + como máximo 3 elementos narrados
  • Ordena los temas por historia: función estrella -> superficie del producto -> rendimiento -> fiabilidad

2 · Enrutamiento de visualizaciones

Para cada tema, elige la superficie del registro de visualizaciones y escribe una línea: tema → superficie → las 2-4 acciones secuenciadas que realizará la maqueta, cada una vinculada a una frase del guion.

3 · Guion de dos capas (hablado vs mostrado)

Escribe el guion como líneas de tokens: registro conversacional, cada término técnico lleva una forma fonética spoken mientras que display mantiene la ortografía estándar. Los subtítulos muestran display; la locución lee spoken.

4 · Locución + marcas de tiempo de palabras

node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json

Las marcas de tiempo por palabra son un punto de control obligatorio. Antes de continuar, verifica que vo-words.json no esté vacío y contenga un array words: [...] con start/end por cada palabra.

5 · Construcción

Sigue exactamente references/build-spec.md: tokens de marca + fuentes + codificación del fondo animado + esqueleto de escena + interfaz de usuario + barra de subtítulos. Luego, el orden de la doctrina: vector ledger → seam-stamp → pulsos internos sobre las palabras de la locución → verificación seam-gate.

Los subtítulos no son opcionales. Llena el array LINES desde captions.json antes de continuar.

6 · Verificaciones (todas en verde antes de presentar)

  1. hyperframes check — 0 errores
  2. seam-gate.mjs verify — 0 fallos
  3. Reinicia el servidor de previsualización, comprueba 3-4 momentos clave
  4. NO renderices a menos que el usuario lo pida
  5. Verificación de presencia de subtítulos — muestrea 3-4 fotogramas, confirma que la barra de subtítulos sea visible

Tabla Antirracionalización

RacionalizaciónRealidad
"Diapositivas con viñetas para cambios en la IU"Simula la superficie actuando el cambio
"IU falsa para elementos no representables"Escena de lista honesta
"'JSON' simple en el texto de TTS"Formas fonéticas del léxico; la visualización mantiene la ortografía estándar
"Adivinar la pronunciación"Pregunta, luego amplía el léxico
"Narrar cada elemento del changelog"≤3 por tema; el enlace al resumen lleva el resto
"Acentos verdes por todas partes"Un momento verde por escena
"Empezar desde el index.html de un video anterior"Copia master-skeleton.html, siempre
"Un array LINES vacío está bien"LINES vacío = video sin subtítulos = repetir la ejecución

Verificación

  • hyperframes check pasa con 0 errores
  • seam-gate.mjs verify pasa con 0 fallos
  • Barra de subtítulos visible en 3+ fotogramas muestreados
  • Las marcas de tiempo de palabras se alinean con el audio
  • Los tokens de marca coinciden con build-spec.md
  • Solo se renderiza cuando el usuario lo solicita explícitamente

Individual skills in this repo

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

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

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video using HyperFrames. Use when the user wants a topic explainer, concept breakdown, how-to, or listicle with no product/website to capture. Every visual is invented per scene (typography, abstract graphics, diagrams, data-viz). Not a video built from a website (use hyperframes-product-launch-video).

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