Primero, mantén esta habilidad actualizada — confirma con el usuario antes de ejecutar:
npx hyperframes skills update faceless-explainer. Una operación rápida cuando todo está al día; de lo contrario, actualiza esta habilidad y las habilidades del dominio central de las que depende antes de usarlas.
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 la habilidad/media-use.
Explicador Sin Rostro a HyperFrames
Usa esta habilidad para convertir un cuerpo de texto en un video explicativo: elige un sistema de diseño, planifica una historia didáctica y constrúyela fotograma a fotograma en HyperFrames. Sin rostro significa que cada elemento visual se inventa en el proceso posterior — 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, y solo entonces continúa. Esta habilidad es para explicar un tema desde texto, sin producto y sin 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 todas formas (la regla de apertura de Setup).
Eres el orquestador. Trabaja en videos/<project>/. Ejecuta los pasos en orden y pasa cada puerta antes de continuar. Los pasos con puerta de usuario son el Paso 0, el Paso 3 y el Paso 6. Lee ../hyperframes/references/brief-contract.md antes del Paso 0 — define los tipos de puerta y cómo flow/storyboard de BRIEF.md derivan el modo que rige las puertas de los Pasos 3/4/6. Haz cada paso tú mismo excepto el Paso 5, donde despachas un subagente por fotograma. No pongas reglas de diseño o animación aquí; esas viven en el subagente trabajador de fotogramas, en las ../hyperframes-animation/rules/ locales de esta habilidad + ../hyperframes-animation/blueprints/ y hyperframes-creative.
Flujo de trabajo: Paso 0 configuración → hyperframes.json; Paso 1 brief → capture/extracted/; Paso 2 sistema de diseño → frame.md; Paso 3 storyboard/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 y index.html; Paso 6 render final → renders/video.mp4.
Paso 0: Configuración
Objetivo: Ingresar con un brief confirmado, crear el proyecto HyperFrames y hacer duradero el brief.
El brief es confirmado por la capa de intención, no por preguntas aquí. Regla de apertura, en orden: (1) BRIEF.md existe → léelo y no preguntes nada — el brief está resuelto, y su flow/storyboard derivan el modo (contrato de brief § 1). (2) No hay BRIEF.md pero el proyecto existe (hyperframes.json / STORYBOARD.md en disco) → reanuda desde el frontmatter del storyboard y las preferencias registradas; nunca vuelvas a interrogar un proyecto a medio construir. (3) Ni lo uno ni lo otro — 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 brief bloqueado. Las solicitudes de edición omiten todo esto — ve a hacer la edición.
Inicializa solo si falta hyperframes.json. Nombra <project> a partir del tema en kebab-case, como compound-interest-explained; nunca uses el nombre del espacio de trabajo o una marca de tiempo.
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=faceless-explainer — init verifica las habilidades instaladas contra las últimas en GitHub y actualiza el conjunto global si alguna está desactualizada.
Después de init, deja que <PROJECT_ROOT> sea videos/<project> y ejecuta cada comando de ruta relativa posterior con ese directorio como su 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 brief bloqueado de la capa de intención, con la forma según ../hyperframes/references/brief-format.md. Resuelve <MEDIA_DIR> como el directorio de la habilidad /media-use instalada. Luego registra cada respuesta respaldada por 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 <name>; copia su frame.md en el proyecto (el Paso 2 se omite entonces) y devuelve los esqueletos a partir de los cuales se redacta el Paso 3. Una receta completa 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 se haya iniciado sesión, 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 offline; saca a la luz el bloqueador. No incluyas esta decisión en otra pregunta ni escribas claves en un .env por repositorio. Propiedad de la autenticación y alternativas offline: /media-use references/setup-providers.md § Proveedores.
Puerta: hyperframes.json y BRIEF.md existen; las respuestas respaldadas por preferencias se registraron (contrato de brief § 2); se mostró el estado de inicio de sesión (iniciada sesión, o continuando offline).
Paso 1: Brief (sin captura)
Objetivo: Incorporar el texto del usuario al proyecto como fuente de información. No hay captura de sitio web ni activos reales — esto 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 completo, 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": [] }. Completatitle/descriptiona partir del brief. Dejacolors/fontsvacíos a menos que el usuario haya dado explícitamente colores o fuentes de marca — en ese caso, agrégalos (el preset de diseño proporciona una paleta completa de todos modos).
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 brief de alguna manera 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 en public/<basename> y anótalo 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 preset de fotograma incluido; un script lo convierte en el frame.md + skin de subtítulos de este video.
Cuando BRIEF.md nombra un style_preset — el usuario lo eligió visualmente de las muestras en la capa de intención — úsalo; la decisión es tuya solo cuando el brief no lo especifica. Luego tomas la única decisión — qué preset: lee ../hyperframes-creative/references/design-spec.md y explora ../hyperframes-creative/frame-presets/; elige el preset 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 el FRAME.md del preset → frame.md y lo remezcla sobre cualquier token de marca en capture/extracted/tokens.json (los colores de marca mapeados a las claves de color del preset por rol; las fuentes de visualización + cuerpo del preset se intercambian por las de la marca), copia el skin de subtítulos del preset a .hyperframes/caption-skin.html, y se autovalida (sale con 1 en un mapeo roto). Procede 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 colors/fonts vacíos) → el script conserva la propia paleta del preset, un diseño completo y listo para usar. Solo cuando el usuario nombró colores/fuentes de marca, agrégalos a tokens.json antes de ejecutar, y solo ajusta frame.md manualmente después si un mapeo realmente lo necesita.
Puerta: build-frame.mjs salió con 0 — frame.md existe a partir de un preset nombrado, y (cuando el preset incluye uno) .hyperframes/caption-skin.html existe como fuente del skin de subtítulos; el preset elegido se registró como preferencia (--key style_preset --workflow <este workflow>, contrato de brief § 2).
Paso 3: Storyboard y Guion
Objetivo: Convertir el texto en un plan de enseñanza aprobado fotograma por fotograma.
Lee ../hyperframes-creative/references/story-spine.md (lenguaje de gancho, valor antes de evidencia, storyboard como propuesta, visuales trazables a la fuente), 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 brief — una expectativa aproximada; el ensamblaje informa dónde cae el corte en relación con ella.
Usa story-design.md para la estructura del explicador (concepto / cómo hacer / 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 los párrafos del texto de entrada — reordena, fusiona, omite, comprime. Como guía suave, consulta el menú rol→blueprint en ../hyperframes-animation/blueprints-index.md: para cada ritmo, escribe la voz en off en la forma que sugiere el blueprint candidato y etiqueta ese candidato con el blueprint: id cuando encaje. La verdad didáctica aún decide qué ritmos existen — nunca fuerces un ritmo para que se ajuste a un blueprint, y nunca inventes un ritmo solo porque hay una forma probada disponible. Los visuales sin rostro se inventan aguas abajo, por lo 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/<basename>. Usa los campos exactos requeridos de las referencias de storyboard y guion.
Después de redactar, 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) u omitir. La retroalimentación llega como una respuesta de chat; repite hasta que se apruebe. Esta es una puerta de punto de control (contrato de brief § 1): en modo autónomo no hay nada que preguntar — publica el mismo resumen como aviso y continúa; los bocetos se colapsan en la compilación, y la única pregunta de vista previa 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 por fotograma (autónomo: el resumen se publicó como aviso).
Paso 3.1: Audio
Objetivo: Generar narración, tiempos de palabras, 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 invocarla. 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 (femenino) en HeyGen / am_michael en Kokoro — por lo 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 (con sesión iniciada) a través de node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list (o GET /v3/voices?engine=starfish); Kokoro (offline) a través de 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 brief § 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 <voice-id> &
El script de audio maneja la narración, los tiempos de las palabras, la búsqueda de BGM de la biblioteca de música de HeyGen y los metadatos de sincronización. El estado de ánimo del BGM proviene del campo music: del storyboard. 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.
Si no hay narración y no hay SCRIPT.md, omite la generación de voz. El BGM aún puede ejecutarse si el storyboard 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 y sin SCRIPT.md. Esa combinación marca el proyecto como silencioso — sin narración, sin BGM, sin SFX. audio.mjs lo reconoce y no genera nada (elimina cualquier audio_meta.json obsoleto; un audio_meta.json ausente es lo que el ensamblaje trata como silencioso), por lo que este paso es una omisión limpia. music: none con narración mantiene TTS y apaga solo el BGM. Usa exactamente esta ortografía — no improvises otros marcadores.
Puerta: el trabajo de audio ha comenzado, o el proyecto está marcado como silencioso (music: none + sin SCRIPT.md).
Paso 4: Diseño Visual de Fotogramas
Objetivo: Añadir la dirección visual, la intención de diseño y las elecciones de movimiento a cada fotograma del storyboard.
Primero haz el boceto de la hoja del storyboard (solo colaborativo). En el momento en que el plan sea aprobado, ejecuta la pasada de boceto — ../hyperframes/references/review-loop.md § 2 (no esperes al Paso 3.1; los bocetos no usan tiempos): crea un esquema de cada fotograma como una celda de storyboard.html (../hyperframes/references/storyboard-board.md; el boceto es la hoja de trabajo de elección de diseño). Cada celda muestra el diseño de diseño (título arriba, diagrama izquierda, cuerpo derecha...), el tipo de toma (plano general, inserto de texto...) y la intención de movimiento (desplazamiento panorámico, zoom, transición...) en texto, no en gráficos renderizados. Lee ../hyperframes-creative/references/visual-design.md para conocer la sintaxis de composición y el sistema de notación de movimiento. Después del boceto, pregúntale al usuario si quieren que los rellenes tú mismo o que cada fotograma los maneje el subagente (Paso 5). Anota la respuesta; esto afecta al Paso 5, no a la redacción de este paso.
Luego completa los campos de diseño. Redacta los campos de diseño en el YAML del storyboard (layout, camera, motion, transition). El ../hyperframes-animation/blueprints-index.md es tu referencia de consulta, no una plantilla forzada. Cuando un fotograma sigue un blueprint ajustado, sus campos de diseño se copian de la entrada visuals_blueprint de ese blueprint; cuando se desvía — porque la verdad didáctica lo requiere o porque el boceto exploró una ruta diferente — redacta los campos manualmente. Se requiere coherencia visual y narrativa.
Después de que se completen los campos de diseño, el storyboard tiene dos modos:
- Rellenado por el orquestador: continúa al Paso 5 sin más puerta.
- Rellenado por el subagente (predeterminado): ejecuta la pasada de revisión de diseño (
../hyperframes/references/review-loop.md§ 3 ) — presenta los bocetos y diseños, pregunta si es necesario un refinamiento o el Paso 5 puede comenzar; luego continúa al Paso 5.
Puerta (ambos modos): STORYBOARD.md tiene layout, camera, motion y transition completos para cada fotograma; los bocetos existen (storyboard.html) y se mostraron al usuario; la pasada de revisión de diseño está completa (modo subagente) u omitida (modo orquestador).
Paso 5: Fotogramas
Objetivo: Construir cada fotograma como un HTML animado independiente y unirlos en una secuencia.
Este es el único paso que despachas. Para cada fotograma en STORYBOARD.md, invoca un subagente trabajador de fotogramas con esta solicitud:
Eres un trabajador de fotogramas de video. Construye el archivo HTML para el fotograma
<N>del proyecto<PROJECT_ROOT>. Usa<PROJECT_ROOT>/frame.mdcomo tu especificación de diseño (fuentes, colores, cuadrícula, reglas de animación). Lee<PROJECT_ROOT>/STORYBOARD.md— el fotograma<N>tiene estos campos narrativos y de diseño. Tu salida es un único archivocompositions/frames/NN-<slug>.htmlautocontenido dentro de<PROJECT_ROOT>(usa rutas relativas paraframe.md,public/,../hyperframes-animation/rules/). Todas las rutas son relativas a<PROJECT_ROOT>. No agregues efectos de desvanecimiento de entrada/salida o curvas de movimiento — los maneja el ensamblaje. No agregues fuentes no estándar. El archivo se reproduce a 30 fps; si el guion usa[pause 1.5], inserta un retraso de fotogramas congelados (usa solicitudAnimationFrame) o controla la duración de la animación para que coincida. Lee las reglas del trabajador en../hyperframes-animation/rules/y los planos en../hyperframes-animation/blueprints/antes de codificar.
Espera a que todos los trabajadores terminen, luego ejecuta node <SKILL_DIR>/scripts/assemble.mjs --hyperframes . — ensambla cada compositions/frames/NN-*.html en index.html con transiciones y tiempos.
No modifiques los HTML de los fotogramas después de que regresen a menos que fallen la validación de ensamblaje (marcos rotos, script faltante); parchéalos en su lugar. Si un fotograma necesita reelaboración — como un cambio de diseño que afecta la coherencia visual — vuelve al Paso 4. Para fallos de la herramienta (comandos que fallan, trabajadores que no responden), reintenta hasta 2 veces; si persisten, notifica al usuario y ofrece soluciones alternativas.
Puerta: index.html existe y reproduce la secuencia completa de fotogramas sin errores de consola.
Paso 6: Render Final
Objetivo: Codificar el video renderizado y recopilar los entregables.
Ejecuta el render: npx hyperframes render --hyperframes .
Luego informa los resultados. Muestra la salida del render en una tabla:
| Métrica | Valor |
|---|---|
| Duración | N/A (rellena después del render) |
| Fotogramas | N/A |
| Resolución | N/A |
| Tamaño del archivo | N/A |
| Duración objetivo | (del brief) |
Pregunta al usuario si el video necesita cambios. Si es así, identifica el problema, retrocede al paso apropiado y repite hasta que esté aprobado. Si está aprobado, felicita al usuario y guarda los metadatos de producción relevantes.
Puerta: renders/video.mp4 existe; el usuario aprobó el video final (autónomo: el video se ha renderizado).