Instalación del plugin: Antes de ejecutar comandos de configuración o actualización, sigue las reglas de ejecución del plugin cuando este skill esté dentro de un plugin de HyperFrames. Las instalaciones independientes conservan las instrucciones de actualización a continuación.
Primero, mantén este skill actualizado — confirma con el usuario antes de ejecutar:
npx hyperframes skills update faceless-explainer. Es una operación rápida y sin efecto cuando todo está al día; de lo contrario, actualiza este skill y los skills del dominio principal de los que depende antes de utilizarlos.
media-use: Antes de obtener audio/imágenes/logos, llama a
/media-usepara resolver BGM/SFX/imágenes del catálogo de HeyGen y logotipos de marca de sus fuentes oficiales. Ejecuta--adoptprimero para registrar activos existentes. Consulta el skill/media-use. Cuando la aplicación anfitriona proporcione sus propias herramientas de música o efectos de sonido, úsalas para música y efectos de sonido.
Faceless Explainer a HyperFrames
Usa este skill para convertir un cuerpo de texto en un video explicativo: elige un sistema de diseño, planifica una historia didáctica y constrúyelo fotograma a fotograma en HyperFrames. Faceless (sin rostro) significa que cada visual se inventa aguas abajo — no hay paso de captura ni inventario de activos reales.
La puerta de entrada es
/hyperframes. Tú eres el orquestador. Ejecuta cada paso, verifica su puerta de control y solo entonces continúa. Este skill es para explicar un tema a partir de texto, sin producto ni sitio web que capturar. Cualquier otra intención, un simple "haz un video" o cualquier incertidumbre → lee/hyperframesprimero — la capa de intención posee cada decisión de ruta, y una creación nueva que llegue aquí sinBRIEF.mdpasa por ella de todos modos (regla de apertura de Configuración).
Eres el orquestador. Trabaja en videos/<proyecto>/. Ejecuta los pasos en orden y pasa cada puerta antes de continuar. Los pasos con puerta de usuario son el Paso 0, Paso 3 y Paso 6. Lee ../hyperframes/references/brief-contract.md antes del Paso 0 — define los tipos de puerta y cómo BRIEF.md con su flow/storyboard derivan el modo que gobierna las puertas de los Pasos 3, 4 y 6. Haz cada paso tú mismo excepto el Paso 5, donde despachas un sub-agente por fotograma. No pongas reglas de diseño o movimiento aquí; esas viven en el sub-agente trabajador de fotogramas, en ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ y hyperframes-creative.
Flujo de trabajo: Paso 0 configuración → hyperframes.json; Paso 1 resumen → capture/extracted/; Paso 2 sistema de diseño → frame.md; Paso 3 guion gráfico/guion → STORYBOARD.md y SCRIPT.md; Paso 3.1 audio → audio_meta.json; Paso 4 diseño visual → STORYBOARD.md enriquecido; Paso 5 fotogramas → compositions/frames/NN-*.html e index.html; Paso 6 render final → renders/video.mp4.
Paso 0: Configuración
Objetivo: Entrar con un resumen confirmado, crear el proyecto HyperFrames y hacer duradero el resumen.
El resumen lo confirma la capa de intención, no las preguntas aquí. Regla de apertura, en orden: (1) BRIEF.md existe → léelo y no preguntes nada — el resumen está definido, y su flow/storyboard derivan el modo (contrato de resumen § 1). (2) No hay BRIEF.md pero el proyecto existe (hyperframes.json / STORYBOARD.md en disco) → reanuda desde el frontmatter del guion gráfico y las preferencias registradas; nunca vuelvas a interrogar un proyecto a medio construir. (3) Ninguno — una solicitud de creación nueva que llegó aquí directamente → lee /hyperframes y ejecuta su capa de intención (references/intent-interview.md): verifica recetas y valores predeterminados recordados, realiza las preguntas de esta ruta (../hyperframes/references/routes/faceless-explainer.md) y devuelve el resumen bloqueado. Las solicitudes de edición saltan todo esto — ve a hacer la edición.
Inicializa solo si falta hyperframes.json. Nombra <proyecto> a partir del tema en kebab-case, por ejemplo compound-interest-explained; nunca uses el nombre del espacio de trabajo o una marca de tiempo.
npx hyperframes init "videos/<proyecto>" --non-interactive --example=blank --skill=faceless-explainer — init verifica los skills instalados contra los últimos en GitHub y actualiza el conjunto global si alguno está desactualizado.
Después de init, deja que <PROJECT_ROOT> sea videos/<proyecto> y ejecuta todos los comandos de ruta relativa posteriores con ese directorio como directorio de trabajo. En los comandos a continuación, . significa <PROJECT_ROOT>; nunca escribas .media, capture o archivos de salida en el directorio de la llamada.
Escribe BRIEF.md inmediatamente después de init (nunca antes — init rechaza un directorio no vacío): el resumen bloqueado de la capa de intención, con la forma según ../hyperframes/references/brief-format.md. Resuelve <MEDIA_DIR> como el directorio del skill /media-use instalado. Luego registra cada respuesta basada en preferencias con node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . (brief-format.md nombra el subconjunto). Si la capa de intención adoptó una receta, ejecuta node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <nombre>; copia su frame.md en el proyecto (el Paso 2 se salta entonces) y devuelve los esqueletos a partir de los cuales se redacta el Paso 3. Una receta llena respuestas, no aprobaciones; las puertas de revisión aún se ejecutan.
Muestra el estado de inicio de sesión antes de continuar más allá de la Configuración — ejecuta npx hyperframes auth status y transmite su salida textualmente. Informa si la voz/BGM usará HeyGen o motores locales y, cuando no haya sesión iniciada, cómo iniciarla. Aplica una rama:
- Colaborativo: espera a que el usuario inicie sesión o elija explícitamente
offline/go. - Autónomo: indica el estado y continúa a través de los motores locales disponibles.
No omitas silenciosamente una capacidad requerida cuando no exista un proveedor fuera de línea; muestra el bloqueo. No incluyas esta decisión en otra pregunta ni escribas claves en un .env por repositorio. Propiedad de autenticación y alternativas fuera de línea: /media-use references/setup-providers.md § Proveedores.
Puerta: hyperframes.json y BRIEF.md existen; las respuestas basadas en preferencias se registraron (contrato de resumen § 2); se mostró el estado de inicio de sesión (sesión iniciada o continuando sin conexión).
Paso 1: Resumen (sin captura)
Objetivo: Incorporar el texto del usuario al proyecto como fuente de información. No hay captura de sitio web ni activos reales — es un explicador sin rostro.
Guarda la entrada completa del usuario textualmente, luego crea el paquete de captura sintético manualmente:
capture/extracted/visible-text.txt— el artículo / notas / tema / resumen completos, textualmente. Esta es la fuente de información, no una plantilla de historia (el Paso 3 la reforma).capture/extracted/tokens.json—{ "title": "", "description": "", "colors": [], "fonts": [] }. Rellenatitle/descriptiona partir del resumen. Dejacolors/fontsvacíos a menos que el usuario haya dado explícitamente colores o fuentes de marca; entonces agrégalos (el ajuste preestablecido de diseño proporciona una paleta completa independientemente).
Si el usuario pegó un guion o quiere que se conserve su redacción, guárdalo textualmente como user_script.txt; VO_MODE (textual o reestructurado) proviene de BRIEF.md — la capa de intención lo pregunta cuando llega un guion. Pregunta una vez aquí solo si el resumen carece de ello y almacena la respuesta para el Paso 3.
No ejecutes npx hyperframes capture (no hay URL). No crees asset-descriptions.md ni pobles capture/assets/ — los visuales sin rostro se inventan en los Pasos 4-5, no se capturan. La única excepción: si el usuario proporcionó una imagen real, colócala bajo public/<nombre_base> y anótala para el Paso 3.
Puerta: capture/extracted/visible-text.txt y capture/extracted/tokens.json existen; puedes indicar el tema y la audiencia del explicador en una oración clara.
Paso 2: Sistema de diseño
Objetivo: Elegir un ajuste preestablecido de fotograma incluido; un script lo convierte en el frame.md + aspecto de subtítulos de este video.
Cuando BRIEF.md nombre un style_preset — el usuario lo eligió visualmente en las exhibiciones de la capa de intención — úsalo; la decisión es tuya solo cuando el resumen está en silencio. Luego tomas la única decisión — qué ajuste preestablecido: lee ../hyperframes-creative/references/design-spec.md y navega por ../hyperframes-creative/frame-presets/; elige el ajuste preestablecido cuyo aspecto se adapte mejor al tema, tono y audiencia. Luego ejecuta:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <nombre> --hyperframes .
El script hace el resto de manera determinista: copia FRAME.md del ajuste preestablecido → frame.md y lo remezcla sobre cualquier token de marca en capture/extracted/tokens.json (los colores de marca se asignan a las claves de color del ajuste preestablecido por función; las fuentes de visualización y cuerpo del ajuste preestablecido se cambian por las de la marca), copia el aspecto de subtítulos del ajuste preestablecido a .hyperframes/caption-skin.html y se autovalida (sale con 1 en un mapeo incorrecto). Continúa tan pronto como salga con 0 — sin edición manual de la especificación.
Un explicador sin rostro generalmente no tiene colores/fuentes de marca (tokens.json colores/fuentes vacíos) → el script conserva la paleta propia del ajuste preestablecido, un diseño completo y entregable. Solo cuando el usuario nombra colores/fuentes de marca, agrégalos a tokens.json antes de ejecutar, y solo ajusta frame.md a mano después si un mapeo realmente lo necesita.
Puerta: build-frame.mjs salió con 0 — frame.md existe desde un ajuste preestablecido nombrado, y (cuando el ajuste preestablecido incluye uno) .hyperframes/caption-skin.html existe como fuente del aspecto de subtítulos; el ajuste preestablecido elegido se registró como preferencia (--key style_preset --workflow <este flujo>, contrato de resumen § 2).
Paso 3: Guion gráfico y guion
Objetivo: Convertir el texto en un plan de enseñanza fotograma a fotograma aprobado.
Lee ../hyperframes-creative/references/story-spine.md (lenguaje de gancho, valor antes de evidencia, guion gráfico como propuesta, visuales trazables a fuentes), references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes/references/storyboard-format.md y ../hyperframes/references/script-format.md. Úsalos para escribir STORYBOARD.md y, cuando se necesite narración, SCRIPT.md. Establece el duration: del frontmatter a partir del length del resumen — una expectativa aproximada; el ensamblaje informa dónde cae el corte en relación con él.
Usa story-design.md para la estructura del explicador (concepto / tutorial / lista / historia), estrategia de gancho, técnicas de claridad, ritmos emocionales, el mapeo de enumeración de tipos y VO_MODE. La secuencia del video proviene del diseño narrativo, no del orden de párrafos del texto de entrada — reordena, fusiona, omite, comprime. Como una guía suave, consulta el menú de rol→modelo en ../hyperframes-animation/blueprints-index.md: para cada ritmo, escribe la voz en off en la forma que implica su modelo candidato y etiqueta ese candidato con blueprint: id cuando encaje. La verdad didáctica aún decide qué ritmos existen — nunca fuerces un ritmo para que encaje en un modelo, y nunca inventes un ritmo solo porque una forma probada está disponible. Los visuales sin rostro se inventan aguas abajo, así que los fotogramas no llevan un inventario de activos: deja asset_candidates vacío a menos que el usuario haya proporcionado una imagen real public/<nombre_base>. Usa los campos exactos requeridos de las referencias de guion gráfico y guion.
Después del borrador, ejecuta la pasada de plan del bucle de revisión — ../hyperframes/references/review-loop.md § 1: presenta el plan como una propuesta y haz las dos preguntas — aprobar o cambiar, y bocetos primero (recomendado) o saltarlos. La retroalimentación llega como respuesta de chat; repite hasta que se apruebe. Esta es una puerta de control (contrato de resumen § 1): en modo autónomo no hay nada que preguntar — publica el mismo resumen como aviso y continúa; los bocetos se integran en la construcción, y la vista previa final con su única pregunta llega en el Paso 6.
Puerta: STORYBOARD.md existe, cada fotograma tiene los campos narrativos requeridos, SCRIPT.md existe cuando se necesita narración y el usuario aprobó el plan fotograma a fotograma (autónomo: el resumen se publicó como aviso).
Paso 3.1: Audio
Objetivo: Generar narración, tiempos de palabra, música y metadatos de audio a partir del guion aprobado.
Inicia el audio después de la aprobación del Paso 3. Ejecútalo en segundo plano, luego continúa al Paso 4. (El estado de inicio de sesión ya se mostró en el Paso 0; el motor retrocede automáticamente).
Elige la voz de narración a partir de la solicitud del usuario antes de invocar. Si la solicitud nombró una voz, género o tono, elige un id de voz coincidente y pásalo con --voice <id>. El valor predeterminado de la canalización es Marcia (femenina) en HeyGen / am_michael en Kokoro — así que una solicitud como "una voz masculina" se ignora silenciosamente a menos que pases la bandera. Los ids de voz son específicos del proveedor; resuélvelos según el proveedor que seleccionó el estado de inicio de sesión del Paso 0: HeyGen (sesión iniciada) mediante node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list (o GET /v3/voices?engine=starfish); Kokoro (fuera de línea) mediante la tabla de voces en <MEDIA_DIR>/audio/references/tts.md (prefijos am_/bm_ masculino, af_/bf_ femenino). Cuando el usuario no expresó preferencia, recurre a la voz recordada (contrato de resumen § 2) antes del valor predeterminado de la canalización, y di cuál usaste; omite --voice solo cuando ninguno nombra una. Cuando el usuario eligió explícitamente una voz en esta ejecución, regístrala (prefs.mjs record --key voice).
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <id-voz> &
El script de audio maneja la narración, los tiempos de palabra, la búsqueda de BGM de la biblioteca musical de HeyGen y los metadatos de sincronización. El estado de ánimo del BGM proviene del campo music: del guion gráfico. Esto usa la API de Audio de HeyGen para recuperación, no generación, y la misma credencial ~/.heygen que TTS. Para detalles del proveedor, lee ../media-use/audio/references/tts.md. Cuando las herramientas propias de la aplicación anfitriona hacen la música o un efecto de sonido, coloca el archivo bajo assets/ y enuméralo en el archivo audio_meta.json marcado con "source": "host": música como bgm { "path": "assets/…", "source": "host" } con music: none en el guion gráfico; un sonido como una entrada sfx { "frame": <n>, "file": "assets/…", "offset_s": 0, "duration_s": <su duración>, "source": "host" }. Cada pase de audio los conserva, y un fotograma con un sonido del anfitrión no obtiene ninguna señal buscada.
Si no hay narración ni SCRIPT.md, omite la generación de voz. El BGM aún puede ejecutarse si el guion gráfico tiene un estado de ánimo musical.
El marcador canónico de silencio total (compartido entre los flujos de trabajo que reutilizan este modelo de audio): music: none en el bloque YAML superior de STORYBOARD.md, sin SCRIPT.md, y sin señales sfx: ni audio del anfitrión. Esa combinación marca el proyecto como silencioso – n