Communitygithub.com

AlessandroFare/fluxychat

Convierte un changelog .md semanal en un video de changelog animado (cuadrado 1080, ~45-60s, voz de Annie, fondo animado de marca, visualizaciones mock-UI, subtítulos discretos). Úsalo cuando el usuario proporcione un changelog/digest markdown y quiera el video semanal, o diga 'changelog video'. Es autocontenido: fuentes, fondo, léxico y scripts vienen incluidos en esta skill.

¿Qué es fluxychat?

Esta skill transforma un changelog markdown (como el digest semanal de HyperFrames) en un video de changelog animado, con marca propia y de alta calidad. Genera un proyecto HyperFrames limpio en `projects/active/weekly-changelog-<rango>/`. Su objetivo principal es **visualizar, no listar**: cada tema debe ilustrarse con un mock animado de la interfaz real o un análogo fiel que represente visualmente el cambio, evitando viñetas de texto. La skill sigue un pipeline estricto: primero carga los assets de la skill (fuentes, fondo animado, plantilla maestra) y lee las especificaciones de marca, luego parsea el changelog, planifica las visualizaciones, escribe un guión de dos capas (oral y de display), genera la locución con Annie (HeyGen), alinea los subtítulos, y finalmente construye el proyecto. Incluye compuertas de verificación obligatorias (contraste, costuras, subtítulos) y documenta una serie de antipatrones que evitan errores comunes, como reutilizar plantillas de videos anteriores o no rellenar la matriz de subtítulos. Está diseñada para Claude Code y entornos similares de edición de video programática.

Compatible con✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/AlessandroFare/fluxychat/tree/HEAD/.agents/skills/changelog-video

Preguntar en tu IA favorita

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

Documentación

Changelog → Video de Marca

Entrada: un changelog .md (temas + elementos, como el digest semanal de HyperFrames). Salida: un proyecto HyperFrames limpio, listo para revisión, en projects/active/weekly-changelog-<rango>/. Renderizar solo cuando se pida.

Cargar primero, no negociable: motion-doctrine (+ cut-the-curve, oversized-cursor si aparece un cursor, seam-craft) y captions-overlay. Esta skill provee el pipeline específico del changelog; el doctrine provee la ley de movimiento.

La directriz principal: visualiza, no enumres

Cada tema se ilustra con un mock animado de la interfaz real o un análogo fiel que represente visualmente el cambio en la experiencia — nunca viñetas de texto. Enruta cada tema/elemento a través de references/visualization-registry.md ANTES de escribir el guión; el registro decide ui-recreate / ui-analog / terminal / checklist. La checklist de texto es el ÚLTIMO recurso, reservado para elementos genuinamente no visuales (listas de correcciones de fiabilidad).

Pipeline

0 · Inicializar el proyecto desde los assets de ESTA skill — no negociable

Haz esto antes de escribir cualquier composición HTML. Omitirlo siempre produce un video que se parece a un proyecto similar que construiste antes, NO a la marca de esta skill — esa es la forma más común de que esta skill se salga de la marca. Los assets, fuentes y andamio de la skill SON la skill; el prompt SKILL.md es un enrutador.

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 (no hojeado) — define los tokens de marca (TT Norms Pro + ABC Solar Display + TT Norms Mono, crema #f5f6f4, verde racionado #5ef17c, tarjetas de vidrio con bordes de tinte verde, forma de pastilla para kicker/sec-chip, carril de subtítulos de 32px en top: 990) que cada escena hereda del andamio.

Solo ENTONCES comienza los pasos 1-6 a continuación. Los pasos 1-4 (analizar, enrutar, guionizar, VO) planifican lo que va en el andamio; el paso 5 completa los marcadores de posición (<RANGE>, <TOTAL>, <CUT_N>, <DUR_N>, cuerpos de escena) dentro del ya copiado project/index.html — NO reescribes el cromo, las fuentes, la paleta o la carcasa del andamio.

Si te ves a punto de usar cp en el index.html de un video anterior, o escribir tus propias declaraciones @font-face, o diseñar un fondo de shader WebGL en lugar de usar el MP4 de patrón de fondo codificado arriba: DETENTE. Borra el index.html actual y reinicia desde el cp del andamio maestro. Reconstruir el contenido de la escena sobre el andamio correcto es más barato que adaptar la marca a posteriori sobre un andamio incorrecto.

1 · Analizar + corte editorial

  • Extraer: rango de semana, estadísticas del titular (lanzamientos, commits), temas, elementos.
  • Presupuesto: 45-60s total. Título ≤2s, outro ≤3.5s, 4 temas ≈ 9-12s cada uno.
  • Por tema, mantener UNA visualización héroe + como máximo 3 elementos hablados. Todo lo demás existe solo como puntero al "digest completo" del outro. Cortar es el trabajo: un changelog con 30 elementos aún produce ≤14 compases hablados.
  • Ordenar temas por historia: función destacada → superficie del producto → rendimiento → fiabilidad (el digest ya suele leerse así).

2 · Enrutamiento de visualización

Para cada tema, elegir la superficie de references/visualization-registry.md y escribir una línea: tema → superficie → las 2-4 acciones secuenciadas que realiza el mock, cada una vinculada a una frase del guión. Si ninguna superficie del registro encaja y no existe un análogo fiel, es una escena de checklist — no inventes una UI falsa para algo que no podemos representar honestamente.

3 · Guión de dos capas (oral vs display)

Escribir el guión como líneas token según references/script-voice.md: registro conversacional, cada término técnico lleva una forma spoken fonética de references/lexicon.json, mientras que display mantiene la ortografía estándar. Los subtítulos muestran display; el VO lee spoken. Cualquier término que no esté en el léxico: DETENTE y pregunta al usuario cómo se pronuncia, luego agrégalo al léxico. Guardar como script-tokens.json en el proyecto.

4 · VO — Annie (HeyGen, fija)

# texto de la capa oral solamente; words JSON = marcas de tiempo de referencia del texto HABLADO
# Ruta nativa del repositorio: la skill changelog-video se ejecuta desde la raíz del repositorio hyperframes,
# por lo que usa el asistente TTS de hyperframes-media directamente (sin paso de instalación `npx hyperframes`
# skills). Si has copiado la skill en otro repositorio, reemplaza con tu propia ruta a
# la herramienta heygen-tts.mjs de media-use / hyperframes-media.
node skills/hyperframes-media/scripts/heygen-tts.mjs ./vo-spoken.txt \
  -o voiceover.mp3 --words vo-words.json \
  --voice 330290724a1b470fb63153f34d4c0183   # Annie — realista (no sustituir)

Requiere CLI heygen ≥0.3.0 autenticado (heygen auth login --oauth). Luego alinear las marcas de tiempo habladas de vuelta a los tokens de display:

node <SKILL_DIR>/scripts/align-captions.mjs \
  --tokens script-tokens.json --words vo-words.json --out captions.json

captions.json es la entrada del carril de subtítulos (ortografía de display, temporización hablada). El alineador imprime advertencias MISMATCH — resuelve cada una antes de construir (generalmente una ortografía del léxico que el TTS renderiza como múltiples palabras). El audio es el reloj: todos los tiempos de compás provienen de vo-words.json; una regeneración de VO reabre cada costura.

Las temporizaciones de palabras son una compuerta estricta. Antes de pasar al paso 5, verifica que vo-words.json no esté vacío y tenga un array words: [...] con start/end por palabra. Si está vacío (0 bytes) o falta el array — un modo de fallo conocido cuando el proveedor TTS devuelve audio pero sin carga útil de marcas de tiempo — NO CONTINÚES sin ellas. Plan de contingencia: alinear forzadamente el audio producido contra el guión de display usando whisper local:

uvx --from openai-whisper whisper voiceover.mp3 \
  --model base.en --language en --word_timestamps True \
  --output_format json --output_dir .
# luego ejecutar align-captions.mjs con --words voiceover.json (misma forma)

Whisper malinterpreta las representaciones TTS ("gee-sap" → "gsap", "heyjen" → "hey Jen", etc.) — los subtítulos siguen usando la ortografía DISPLAY de script-tokens.json; whisper solo proporciona las marcas de tiempo. align-captions.mjs maneja la unión. Este plan de contingencia es la diferencia entre una compilación subtitulada y una silenciosamente sin subtítulos.

5 · Construir

Seguir references/build-spec.md exactamente: tokens de marca + fuentes (incluidas en <SKILL_DIR>/assets/), la codificación del fondo animado, andamio de escena, cromo, carril de subtítulos, un momento de verde racionado por escena. Luego el orden del doctrine: ledger.json (todas las costuras ordinarias cut-the-curve LEFT) → seam-stamp → compases internos en palabras de VO → verificación seam-gate.

Los subtítulos no son opcionales. El esqueleto maestro incluye un IIFE de carril de subtítulos que lee un array LINES — dejar ese array vacío es un error de envío, no una elección de estilo. Poblarlo desde captions.json antes de pasar al paso 6:

// pegar en lugar de "const LINES = /* … */ []" en el IIFE del carril de subtítulos:
const LINES = /* contenido de captions.json */ [
  { id: 0, end: 2.74, w: [["Esta", 0.0], ["semana,", 0.30], …] },
  …
];

Si align-captions.mjs se omitió o LINES está [], la verificación de fotogramas en el paso 6 fallará — no lo ocultes eliminando #cap-line del andamio.

6 · Compuertas (todas en verde antes de presentar)

  1. bun run --cwd packages/cli hyperframes check (o el CLI hyperframes instalado desde la skill skills/hyperframes-cli/ local del repositorio) — 0 errores (contraste: texto tenue ≥ .66 alpha). NO usar npx hyperframes@latest; el CLI local rastreado del repositorio es la fuente de verdad para el contrato de composición que esta skill produce.
  2. seam-gate.mjs verify — 0 fallos.
  3. Reiniciar el servidor de vista previa (almacena en caché el paquete), revisar 3-4 compases mediante __player.seek en la página de composición sin procesar.
  4. NO renderizar a menos que el usuario lo pida. Después de un render solicitado, verificar fotogramas del MP4 (ffmpeg -ss <t> … -frames:v 1): subtítulos presentes, video de fondo no negro, sin fotogramas pequeños/congelados.
  5. Comprobación de presencia de subtítulos — fallo estricto. Muestrear 3-4 fotogramas distribuidos en la ventana hablada del VO (por ejemplo, t=3, t=15, t=30, t=42 para un VO de 48s) y confirmar que el carril de subtítulos en top: 990 renderiza texto visible en cada uno. Si algún fotograma en un intervalo hablado carece de subtítulos, la compilación se envía sin subtítulos — tratarlo como una compuerta roja y volver a verificar la población de LINES del paso 5. Esto es exactamente lo que salió mal en la compilación v4 del 13-20 de julio.

Estructura del proyecto

projects/active/weekly-changelog-<rango>/
├── index.html            # maestro de documento único (escenas como diapositivas, costuras selladas)
├── ledger.json           # vector ledger (entrada seam-stamp)
├── script-tokens.json    # guión de dos capas (fuente de verdad para VO + subtítulos)
├── vo-spoken.txt         # generado: capa oral, una línea
├── voiceover.mp3 + vo-words.json + captions.json
├── bgm.mp3               # copia de <SKILL_DIR>/assets/bgm.mp3 (la pista base) a menos que el usuario proporcione una
└── assets/fonts/ + assets/bg-pattern-<dur>s.mp4

Antipatrones

No hacerEn su lugar
Diapositivas con viñetas para cambios de UIMock de la superficie representando el cambio
UI falsa para elementos no representablesEscena de checklist honesta
"JSON"/"CLI" simple en el texto TTSFormas habladas del léxico; display permanece estándar
Ortografías fonéticas en subtítulosLos subtítulos siempre renderizan la capa de display
Adivinar la pronunciación de un término desconocidoPreguntar, luego ampliar el léxico
Hablar cada elemento del changelog≤3 por tema; el enlace del digest lleva el resto
Acentos verdes en todas partesUn momento verde por escena (#5ef17c)
Empezar desde el index.html de un video anteriorPaso 0 — copiar examples/master-skeleton.html de esta skill en project/index.html, siempre
@font-face / shader WebGL / BGM personalizado hecho a manoPaso 0 — copiar los assets/ de esta skill textualmente; los assets de la skill SON la marca
Entregar sin invalidación de CloudFrontEjecutar aws cloudfront create-invalidation en la distribución E2BSLVSZ7FG3U0 para la ruta exacta después de cualquier reemplazo en S3 — de lo contrario, el CDN almacena en caché el archivo antiguo
Enviar con el array LINES vacío en el andamioEl paso 4 debe producir un captions.json poblado; el paso 5 debe pegarlo en el IIFE; la compuerta 6 del paso 6 debe confirmar subtítulos en los fotogramas renderizados. Un LINES vacío = envío sin subtítulos = repetir
No tener vo-words.json → omitir subtítulos y enviar igualRecurrir a la alineación forzada con whisper sobre el audio producido; los subtítulos no son opcionales

Individual skills in this repo

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

AlessandroFare/fluxychat

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.\n

AlessandroFare/fluxychat

Use when audio already placed in a HyperFrames composition needs to be mixed: a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.\n

AlessandroFare/fluxychat

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.\n

AlessandroFare/fluxychat

Install, discover, and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

AlessandroFare/fluxychat

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.\n

AlessandroFare/fluxychat

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

AlessandroFare/fluxychat

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

AlessandroFare/fluxychat

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

AlessandroFare/fluxychat

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

AlessandroFare/fluxychat

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

AlessandroFare/fluxychat

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

AlessandroFare/fluxychat

Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

AlessandroFare/fluxychat

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

AlessandroFare/fluxychat

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

AlessandroFare/fluxychat

Design and improve user interfaces using the concrete rules from Refactoring UI (Wathan & Schoger) — constrained spacing/type/color/shadow scales, visual hierarchy through weight and color rather than size, and depth through emulated light. Use when building or styling any UI (web, app, dashboard, landing page, component), when picking font sizes, spacing, colors, shadows or border radius, when designing a color palette or design tokens, and whenever someone says a UI "looks off", "looks amateur", "feels cluttered/plain/unfinished", or asks to "make this look better".

AlessandroFare/fluxychat

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

AlessandroFare/fluxychat

Use before UI-related work to select the smallest useful UI Skills context through the ui-skills CLI.

Skills relacionados