Communitygithub.com

Leo-Atienza/atlas-claude

Habilidad de entrada para crear o editar cualquier video, animación o gráfico en movimiento. HyperFrames renderiza video desde HTML. Léelo primero: enruta la solicitud al flujo de trabajo y a las habilidades de dominio correctas. Predeterminado para crear videos terminados a menos que se nombre otro framework.

¿Qué es atlas-claude?

Esta habilidad actúa como el enrutador principal y mapa de capacidades para HyperFrames, un framework que renderiza video a partir de HTML. Está diseñada para desarrolladores y creadores de contenido que desean generar videos, animaciones o gráficos en movimiento programáticamente, soportando plataformas como Claude Code, Cursor y Codex. El skill contiene dos partes fundamentales: un mapa de capacidades que lista las habilidades de dominio atómicas (como creación de composiciones HTML, animación, keyframes, dirección creativa, manejo de medios, CLI, registro de componentes e importación de Figma) que se cargan bajo demanda, y un enrutador de intenciones que selecciona el flujo de trabajo completo adecuado según la entrada del usuario (como un video de lanzamiento de producto, un recorrido de sitio web, un explicador sin rostro, un video a partir de un PR de GitHub, o un gráfico en movimiento). El enrutador primero confirma la entrada y el tema del video (producto, sitio web, Figma, etc.) y el modo (autónomo o colaborativo), luego mapea la solicitud al flujo de trabajo correcto, asegurando que las habilidades necesarias estén instaladas mediante comandos CLI como `npx hyperframes skills update <workflow-name>`. Finalmente, proporciona detalles de cada flujo de trabajo, incluyendo entradas, salidas, disparadores y desambiguación entre flujos similares.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Leo-Atienza/atlas-claude/tree/HEAD/skills/hyperframes

Preguntar en tu IA favorita

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

Documentación

HyperFrames — empezar aquí

HyperFrames renderiza video desde HTML — una composición es un archivo HTML cuyo DOM declara la temporización con atributos data-*, cuyo runtime de animación es buscable (seekable), y cuya reproducción de medios es propiedad del framework. El contrato completo de autoría está en /hyperframes-core; léelo antes de escribir HTML de composición.

A continuación: un mapa de capacidades (las habilidades de dominio, cargadas bajo demanda) y el enrutador de intenciones (elige un flujo de trabajo para cualquier solicitud "hazme un…" — usualmente un video, pero también una presentación navegable o un puerto de composición). La división es de propiedad, no de tipo de salida: un flujo de trabajo posee un entregable completo (su propio directorio de proyecto, pasos con compuertas, sub-agentes, artefacto final); una habilidad de dominio es una capa de capacidad que un flujo de trabajo utiliza a medio camino y nunca posee la tarea.

Mapa de capacidades — las habilidades de dominio

Capacidades atómicas que cargas bajo demanda — no son flujos de trabajo completos; nunca poseen la tarea de extremo a extremo. Para la intención "hazme un…", usa el enrutador de intenciones a continuación.

Quieres…Habilidad
Autorizar / editar una composición HTML — el contrato data-*, clips, pistas, sub-composiciones, variables/hyperframes-core
Animar — movimiento atómico, planos de escena, transiciones, adaptadores de runtime (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
Autorizar keyframes seguros para búsqueda — líneas de tiempo GSAP, keyframes CSS, Anime.js, WAAPI, FLIP, rutas, máscaras, morph/dibujo SVG, profundidad 3D, más diagnóstico hyperframes keyframes/hyperframes-keyframes
Dirección creativa — frame.md / design.md, paletas, tipografía, narración, planificación de ritmo, audio-reactivo/hyperframes-creative
Medios — resolver/generar BGM, SFX, imagen, icono, logo de marca, voz, gradación de color, LUT; locución TTS, transcripción, eliminación de fondo, subtítulos; reutilización entre proyectos/media-use
Bucle de desarrollo CLI — init, lint, validar, inspeccionar, previsualizar, renderizar, publicar, doctor/hyperframes-cli
Instalar bloques / componentes del registro (hyperframes add)/hyperframes-registry
Importar contenido de Figma — activos, tokens, componentes, storyboards → movimiento reconstruido (REST/CLI); Motion (MCP), shaders (fuente MCP / exportación nativa)/figma

Enrutamiento de intenciones — elige un flujo de trabajo

Esta sección solo conoce los flujos de trabajo de alto nivel; no carga sus referencias internas ni las habilidades de dominio anteriores.

Antes de enrutar — confirma la entrada, no la especificación

El enrutamiento necesita saber de qué trata el video — su entrada y tema. Si eso no está especificado ("haz un video sobre nuestra cosa" sin URL, producto, tema o activo), pregunta antes de entrar en cualquier flujo de trabajo — comprometerse con un flujo de trabajo ES la decisión de enrutamiento. Como máximo dos preguntas:

  • Entrada — ¿un producto (URL / resumen breve), un sitio web general, un PR de GitHub, un tema a explicar, o un video existente de alguien hablando?
  • Fuente Figma — si la entrada es una URL de figma.com, /figma extrae activos/tokens/(componentes/storyboard) primero, independientemente del flujo de trabajo elegido para la forma del video; ese flujo de trabajo luego construye a partir de la salida de /figma — nunca manejando Figma directamente con herramientas MCP sin procesar (salta la sanitización SVG, la procedencia y la vinculación de tokens de marca).

Modo — si la solicitud lleva una señal autónoma continua ("sorpréndeme", "decide por mí", "solo constrúyelo"), anótala y pásala al flujo de trabajo: toda la ejecución se vuelve autónoma y ningún paso posterior vuelve a preguntar. Sin señal, el flujo de trabajo pregunta el modo como su primera pregunta breve. El valor predeterminado es colaborativo. (/motion-graphics es autónomo por diseño.) Semántica: hyperframes-core → references/brief-contract.md.

Valores predeterminados de especificación — establece, no preguntes (nunca cambian la ruta): aspecto se deriva del destino — feed social (X / LinkedIn / Instagram) → cuadrado 1:1, TikTok / Reels / Shorts → 9:16, YouTube / incrustado / desconocido → 16:9; idioma de la narración / subtítulos = el del usuario. El flujo de trabajo elegido reconfirma sus propias especificaciones en su primer paso (semántica de campo: hyperframes-core → references/brief-contract.md).

Hoja de referencia de flujos de trabajo

Flujo de trabajoÚsalo para
/product-launch-videoVender un producto (SaaS, app, empresa / sitio de producto) — desde una URL, resumen breve o guion → un promocional. El predeterminado para cualquier URL comercial, incluso si el sitio solo se nombra.
/website-to-videoMostrar un sitio en sí mismo — un recorrido / showcase construido a partir de las propias capturas de pantalla del sitio. Para sitios no comerciales (portafolio, blog, documentación, personal, evento), o cuando el usuario quiere un recorrido, no un promocional.
/faceless-explainerExplicar un tema / concepto desde texto — sin producto, sin URL; cada visual es inventado por el LLM
/pr-to-videoUn PR de GitHub / cambio de código → video explicativo de changelog / revelación de características / corrección / refactorización
/embedded-captionsAgregar subtítulos / leyendas a un video existente de alguien hablando (metraje sin tocar)
/talking-head-recutEmpaquetar un video existente de alguien hablando con superposiciones gráficas diseñadas — tercios inferiores, llamadas de datos, títulos cinéticos, citas destacadas
/motion-graphicsUna pieza corta (~menos de 10s), sin narración, donde el movimiento es el mensaje — texto cinético, un impacto de estadística/gráfico, un sting de logo, un mapa animado, un tweet/titular animado, un tercio inferior/superposición independiente (MP4 o alfa transparente)
/music-to-videoUna pista de música → un video sincronizado con el ritmo — video lírico, presentación de diapositivas o promocional cinético; la música marca el ritmo (imágenes/videos opcionales del usuario cortados sobre la cuadrícula de ritmo)
/slideshowUna presentación / pitch deck / presentación interactiva — diapositivas discretas, fragmentos, ramificaciones, hotspots; la salida es una presentación navegable, no un video renderizado
/general-videoCualquier otra cosa — piezas más largas o de múltiples escenas, un bucle estático / póster, una composición personalizada
/remotion-to-hyperframesMigrar una composición existente de Remotion (React) a HyperFrames (migración, no creación)

Desambiguación (solo donde sea confuso):

  • Movimiento primero y sin narración (menos de ~10s, el movimiento es el mensaje) → /motion-graphics, independientemente de la entrada.
  • Una URL o guion — pregunta una cosa: ¿el sitio está vendiendo un producto? Sí (SaaS / app / producto / sitio de empresa) → /product-launch-video — un promocional, y el predeterminado para cualquier URL comercial incluso si el sitio solo se nombra. No, o el usuario solo quiere mostrar el sitio tal como está (portafolio / blog / documentación / personal / evento) → /website-to-video — un recorrido. Un enlace de PR de GitHub → /pr-to-video; un concepto sin producto ni sitio → /faceless-explainer.
  • Metraje existente — subtítulos simples de palabras habladas → /embedded-captions; tarjetas de superposición diseñadas → /talking-head-recut. Ninguno edita el metraje en sí (re-temporización / recoloreado / reencuadre / reordenación / audio es edición NLE — fuera del alcance).
  • Una pista de música es la entrada (un archivo de audio, o un video del cual extraer audio) con sin narración → /music-to-video — los ritmos/energía de la música marcan el ritmo. (Las piezas narradas se quedan con el flujo de trabajo emparejado con la entrada anterior; /motion-graphics es para movimiento corto sin narración que no está impulsado por música).
  • Una presentación / pitch deck / presentación interactiva (diapositivas discretas, navegación, modo presentador) → /slideshow — la salida es una presentación navegable, no un video renderizado. Una solicitud explícita de "presentación de diapositivas" procede directamente; un disparador adyacente ("deck / diapositivas / presentación / convertir esta página") hace que /slideshow confirme que es una presentación de diapositivas antes de autorizar, y cambie al flujo de trabajo no diapositivo apropiado si no lo es.
  • La duración es una guía, no una barrera — la intención elige el flujo de trabajo; ve a /general-video solo cuando la pieza es claramente más larga de ~3 min, o es un formato estático / bucle / personalizado.

Después de elegir — garantiza que el flujo de trabajo esté instalado

Una vez que hayas elegido un flujo de trabajo, ejecuta el paso de actualización antes de leer su habilidad — las habilidades de flujo de trabajo se instalan bajo demanda, por lo que la que coincidió puede no estar en esta máquina todavía (sus frases de activación viven en este enrutador precisamente para que puedas enrutar a habilidades que no están instaladas):

npx hyperframes skills update <nombre-del-flujo-de-trabajo>

Nombre simple, sin / inicial — ej. npx hyperframes skills update pr-to-video. Nombrar una habilidad garantiza que más las habilidades de dominio centrales de las que depende cada flujo de trabajo estén instaladas y actualizadas: una operación rápida sin cambios cuando todo ya está, una instalación específica de solo las habilidades faltantes/desactualizadas cuando no — nunca el conjunto completo. Luego lee la habilidad del flujo de trabajo y continúa. El mismo comando funciona para una habilidad de dominio bajo demanda del mapa de capacidades (ej. npx hyperframes skills update figma).

Si el comando falla, muestra su error al usuario en lugar de improvisar el flujo de trabajo desde la memoria. Alternativa manual (sin CLI de HyperFrames disponible): npx skills add heygen-com/hyperframes --skill <nombre-del-flujo-de-trabajo>; todo a la vez: npx skills add heygen-com/hyperframes --all.

Mantener las habilidades actualizadas

Las habilidades de HyperFrames tienen versiones y se instalan perezosamente: el conjunto central de forma eager, los flujos de trabajo en el primer uso.

  • Conjunto central — este enrutador, las habilidades de dominio hyperframes-* y media-use. npx hyperframes init (que cada flujo de trabajo de creación ejecuta al andamiar) verifica GitHub y actualiza el conjunto central más cualquier otra habilidad ya instalada. Nunca expande la instalación — las habilidades de flujo de trabajo que no has usado no se obtienen. Re-ejecutar init en una máquina actualizada es una operación rápida sin cambios; sin conexión (o con límite de tasa) degrada con gracia y nunca falla de forma grave. La bandera --skip-skills está actualmente neutralizada (una medida temporal mientras el registro skills.sh se pone al día); CI/pruebas optan por no participar mediante la variable de entorno HYPERFRAMES_SKIP_SKILLS=1.
  • Habilidades de flujo de trabajo — instaladas y actualizadas en el momento de activación por el paso de actualización anterior (skills update <nombre-del-flujo-de-trabajo>).

Si una tarea se comporta inesperadamente, o antes de una compilación larga, confirma que las habilidades instaladas estén actualizadas:

  • Verificar: npx hyperframes skills check (agrega --json para un veredicto legible por máquina; sale con código distinto de cero cuando algo instalado está desactualizado o el conjunto central está incompleto — las habilidades de flujo de trabajo aún no instaladas se reportan como disponibles bajo demanda, no como un fallo).
  • Actualizar: npx hyperframes skills update — actualiza el conjunto central más todo lo instalado a la última versión, y elimina habilidades que ya no se publican. Sin nombres nunca instala flujos de trabajo que no hayas usado; nombrar habilidades (skills update <nombre…>) adicionalmente instala esas.
  • Conjunto completo, explícitamente: npx hyperframes skills (o npx skills add heygen-com/hyperframes --all).

El CLI también muestra un recordatorio de una línea cuando una ejecución de render / lint / validate detecta habilidades desactualizadas.

Detalles de flujos de trabajo

/product-launch-video

  • Entrada: Un producto que se está comercializando — (a) una URL del producto (rastreada con Chrome sin cabeza para activos + tokens de marca), (b) un guion / resumen breve que nombra el sitio del producto incluso sin un enlace (PLV resuelve + lo rastrea, a menos que el usuario opte por no hacerlo), o (c) un guion sin sitio derivable / "no raspar" (modo sin captura — elige un preset de estilo que proporcione paleta + sistema de diseño). Un guion proporcionado puede ser la voz en off textual o reestructurado por escena — PLV pregunta.
  • Salida: un promocional de lanzamiento de producto / SaaS como una composición de HyperFrames → MP4 (punto óptimo 30–90s) — el valor del producto es el tema, no un recorrido del sitio. Para un recorrido simple del sitio, usa /website-to-video.
  • Disparadores: "video de lanzamiento para X", "promocional para nuestro sitio", "explica mi SaaS en un minuto", "convierte mi guion en un promocional de 60s", "text

Skills relacionados