Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

Bucle de desarrollo CLI de HyperFrames — `npx hyperframes` para andamiaje (init), validación (lint, inspect), previsualización, renderizado y solución de problemas del entorno (doctor, browser, info, upgrade). Úselo al ejecutar cualquiera de estos comandos o al solucionar problemas del entorno de compilación/renderizado de HyperFrames. Para comandos de preprocesamiento de activos (`tts`, `transcribe`, `remove-background`), invoque la habilidad `hyperframes-media`.

¿Qué es Tony-Claude-Code-Skills?

HyperFrames CLI es un conjunto de herramientas de línea de comandos para el desarrollo de composiciones de video basadas en HTML. Facilita un flujo de trabajo completo: andamiaje de proyectos con `npx hyperframes init`, linting de archivos de composición (`lint`), inspección visual de diseño (`inspect`), previsualización con recarga en caliente (`preview`) y renderizado a formatos MP4 o WebM (`render`). También incluye comandos de diagnóstico como `doctor` para verificar el entorno (Chrome, FFmpeg, Node, memoria) y `upgrade` para buscar actualizaciones. Está diseñado para agentes de IA como Claude Code y desarrolladores que trabajan con HyperFrames, requiriendo Node.js >= 22 y FFmpeg. El CLI se integra con habilidades específicas: para tareas de preprocesamiento de activos (TTS, transcripción, eliminación de fondo) se debe invocar la habilidad `hyperframes-media`, y al usar Tailwind se debe invocar la habilidad `tailwind`. La inspección visual (`inspect`) detecta problemas de diseño como texto que se sale de burbujas o contenedores, y soporta opciones como `--json` para salida legible por agentes y `--strict` para fallar ante advertencias.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/shengdabai/Tony-Claude-Code-Skills/tree/HEAD/skills/hyperframes-hyperframes-cli

Preguntar en tu IA favorita

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

Documentación

CLI de HyperFrames

Todo se ejecuta a través de npx hyperframes. Requiere Node.js >= 22 y FFmpeg.

Flujo de trabajo

  1. Andamiaje — npx hyperframes init my-video
  2. Escribir — autoría de la composición HTML (consulte la habilidad hyperframes)
  3. Lint — npx hyperframes lint
  4. Inspección visual — npx hyperframes inspect
  5. Previsualización — npx hyperframes preview
  6. Renderizar — npx hyperframes render

Realice lint e inspección antes de la previsualización. lint detecta data-composition-id faltantes, pistas superpuestas y líneas de tiempo no registradas. inspect abre la composición renderizada en Chrome sin interfaz gráfica, recorre la línea de tiempo y reporta texto que se sale de burbujas/contenedores o del lienzo.

Andamiaje

npx hyperframes init my-video                        # asistente interactivo
npx hyperframes init my-video --example warm-grain   # elegir un ejemplo
npx hyperframes init my-video --video clip.mp4        # con archivo de video
npx hyperframes init my-video --audio track.mp3       # con archivo de audio
npx hyperframes init my-video --example blank --tailwind # con Tailwind v4 runtime del navegador
npx hyperframes init my-video --non-interactive       # omitir indicaciones (CI/agentes)

Plantillas: blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph.

init crea la estructura de archivos correcta, copia medios, transcribe audio con Whisper e instala habilidades de codificación de IA. Úselo en lugar de crear archivos manualmente.

Al usar --tailwind, invoque la habilidad tailwind antes de editar clases o tokens de tema. El andamiaje usa Tailwind v4.2 a través del runtime del navegador, no la configuración de Tailwind v3 de Studio.

Linting

npx hyperframes lint                  # directorio actual
npx hyperframes lint ./my-project     # proyecto específico
npx hyperframes lint --verbose        # hallazgos a nivel de información
npx hyperframes lint --json           # legible por máquina

Analiza index.html y todos los archivos en compositions/. Reporta errores (debe corregir), advertencias (debería corregir) e información (con --verbose).

Inspección visual

npx hyperframes inspect                 # inspeccionar diseño renderizado a lo largo de la línea de tiempo
npx hyperframes inspect ./my-project    # proyecto específico
npx hyperframes inspect --json          # hallazgos legibles por agente
npx hyperframes inspect --samples 15    # barrido de línea de tiempo más denso
npx hyperframes inspect --at 1.5,4,7.25 # marcas de tiempo explícitas de fotogramas principales

Úselo después de lint y validate, especialmente para composiciones con burbujas de diálogo, tarjetas, subtítulos o tipografía ajustada. Reporta:

  • Texto que se extiende fuera del contenedor visual o burbuja más cercana
  • Texto recortado por su propia caja de ancho/alto fijo
  • Texto que se extiende fuera del lienzo de la composición
  • Elementos secundarios que escapan de contenedores de recorte

Los errores deben corregirse antes de renderizar. Las advertencias se presentan para revisión del agente; añada --strict para fallar también en advertencias. Los problemas estáticos repetidos se colapsan por defecto para que la salida JSON se mantenga compacta para las ventanas de contexto de LLM. Si el desbordamiento es intencional para una animación de entrada/salida, marque el elemento o ancestro con data-layout-allow-overflow. Si un elemento decorativo nunca debe ser auditado, márquelo con data-layout-ignore.

npx hyperframes layout sigue disponible como un alias de compatibilidad para el mismo pase de inspección visual.

Previsualización

npx hyperframes preview                   # servir directorio actual
npx hyperframes preview --port 4567       # puerto personalizado (predeterminado 3002)

Recarga en caliente ante cambios en archivos. Abre el estudio en su navegador automáticamente.

Al devolver un proyecto al usuario, use la URL del proyecto de Studio, no la ruta de index.html:

http://localhost:<puerto>/#project/<nombre-del-proyecto>

Use el puerto real de la salida de previsualización y el nombre del directorio del proyecto. Por ejemplo, después de npx hyperframes preview --port 3017 en codex-openai-video, reporte http://localhost:3017/#project/codex-openai-video.

Trate index.html solo como contexto de código fuente. Está bien enlazarlo como un archivo de implementación, pero no lo etiquete como el proyecto o la superficie de previsualización.

Renderizado

npx hyperframes render                                # MP4 estándar
npx hyperframes render --output final.mp4             # salida con nombre
npx hyperframes render --quality draft                # iteración rápida
npx hyperframes render --fps 60 --quality high        # entrega final
npx hyperframes render --format webm                  # WebM transparente
npx hyperframes render --docker                       # idéntico byte a byte
IndicadorOpcionesPredeterminadoNotas
--outputrutarenders/nombre_marca_tiempo.mp4Ruta de salida
--fps24, 30, 603060fps duplica el tiempo de renderizado
--qualitydraft, standard, highstandarddraft para iterar
--formatmp4, webmmp4WebM soporta transparencia
--workers1-8 o autoautoCada uno inicia Chrome
--dockerindicadordesactivadoSalida reproducible
--gpuindicadordesactivadoCodificación acelerada por GPU
--strictindicadordesactivadoFallar en errores de lint
--strict-allindicadordesactivadoFallar en errores Y advertencias
--variablesobjeto JSON—Sobrescribir valores de variables declaradas en data-composition-variables
--variables-fileruta—Archivo JSON con valores de variables (alternativa a --variables)
--strict-variablesindicadordesactivadoFallar renderizado en claves no declaradas o errores de tipo en --variables

Guía de calidad: draft mientras itera, standard para revisión, high para entrega final.

Renderizados parametrizados: la composición declara sus variables en la raíz <html> con data-composition-variables — un array JSON de declaraciones ({id, type, label, default} por entrada) que define el esquema. Los scripts internos leen los valores resueltos mediante window.__hyperframes.getVariables(). El CLI --variables '{"title":"Q4 Report"}' es un objeto JSON indexado por id que sobrescribe esos valores predeterminados declarados para un renderizado; las claves faltantes usan el valor predeterminado, por lo que la misma composición se ejecuta sin cambios en la previsualización de desarrollo y en producción. (Los hosts de sub-composiciones también pueden sobrescribir por instancia con data-variable-values — misma forma de objeto, con ámbito en una sola montura de la sub-composición. Consulte la habilidad hyperframes para el patrón completo.)

Preprocesamiento de activos

npx hyperframes tts, transcribe y remove-background producen activos (audio de narración, transcripciones palabra por palabra, video transparente) que se colocan en una composición. Cada uno descarga su propio modelo en la primera ejecución. Para selección de voz, reglas del modelo Whisper (el problema de que .en traduce no-inglés), elección del formato de salida (VP9 alpha WebM vs ProRes) y la cadena TTS → transcribir → subtítulos, invoque la habilidad hyperframes-media.

Solución de problemas

npx hyperframes doctor       # verificar entorno (Chrome, FFmpeg, Node, memoria)
npx hyperframes browser      # gestionar Chrome empaquetado
npx hyperframes info         # detalles de versión y entorno
npx hyperframes upgrade      # buscar actualizaciones

Ejecute doctor primero si falla el renderizado. Problemas comunes: FFmpeg faltante, Chrome faltante, poca memoria.

Otros

npx hyperframes compositions   # listar composiciones en el proyecto
npx hyperframes docs           # abrir documentación
npx hyperframes benchmark .    # comparar rendimiento de renderizado

Individual skills in this repo

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

shengdabai/Tony-Claude-Code-Skills

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

shengdabai/Tony-Claude-Code-Skills

接收抖音、小红书、微信视频号等短视频链接或分享文案,查询作品/账号数据并提取语音文字稿,按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用;运行前检查 TikHub 与轻抖使用凭证,缺少时用新手能理解的方式引导购买和安全配置。

shengdabai/Tony-Claude-Code-Skills

Read-only queue dashboard for workspace-aware ship. (gstack)

shengdabai/Tony-Claude-Code-Skills

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

shengdabai/Tony-Claude-Code-Skills

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

shengdabai/Tony-Claude-Code-Skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

shengdabai/Tony-Claude-Code-Skills

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

shengdabai/Tony-Claude-Code-Skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Skills relacionados