Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

Loop de desenvolvimento via CLI do HyperFrames — `npx hyperframes` para scaffolding (init), validação (lint, inspect), pré-visualização, renderização e depuração do ambiente (doctor, browser, info, upgrade). Use ao executar qualquer um desses comandos ou ao depurar o ambiente de construção/renderização do HyperFrames. Para comandos de pré-processamento de assets (`tts`, `transcribe`, `remove-background`, consulte a habilidade `hyperframes-media`).

O que é Tony-Claude-Code-Skills?

Esta habilidade implementa o fluxo de desenvolvimento completo para projetos HyperFrames através da CLI `npx hyperframes`. Ela automatiza a criação de novos projetos (scaffolding), validação visual e estrutural (lint e inspect), pré-visualização com hot-reload e renderização final de vídeos. Suporta a criação de projetos a partir de diversos templates prontos (como warm-grain, kinetic-type, nyt-graph) e permite parametrizar renders com variáveis declaradas no HTML. A habilidade também oferece ferramentas de diagnóstico (doctor, browser, info, upgrade) para resolver problemas comuns de ambiente, como falta do FFmpeg ou do Chrome. É essencial para desenvolvedores que usam agentes de IA (Claude, Codex, Cursor) para construir e depurar composições de vídeo, garantindo que o loop de edição-validação-pré-visualização-renderização seja executado de forma eficiente e sem erros.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

CLI do HyperFrames

Tudo é executado via npx hyperframes. Requer Node.js >= 22 e FFmpeg.

Fluxo de trabalho

  1. Scaffolding — npx hyperframes init my-video
  2. Escrever — crie a composição HTML (veja a habilidade hyperframes)
  3. Lint — npx hyperframes lint
  4. Inspeção visual — npx hyperframes inspect
  5. Pré-visualizar — npx hyperframes preview
  6. Renderizar — npx hyperframes render

Execute lint e inspect antes da pré-visualização. O lint captura data-composition-id ausente, faixas sobrepostas e timelines não registradas. O inspect abre a composição renderizada no Chrome headless, percorre a timeline e relata texto vazando para fora de balões/contêineres ou do canvas.

Scaffolding

npx hyperframes init my-video                        # assistente interativo
npx hyperframes init my-video --example warm-grain   # escolher um exemplo
npx hyperframes init my-video --video clip.mp4        # com arquivo de vídeo
npx hyperframes init my-video --audio track.mp3       # com arquivo de áudio
npx hyperframes init my-video --example blank --tailwind # com Tailwind v4 em runtime no navegador
npx hyperframes init my-video --non-interactive       # ignorar prompts (CI/agentes)

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

O init cria a estrutura de arquivos correta, copia a mídia, transcreve áudio com Whisper e instala habilidades de IA para codificação. Use-o em vez de criar arquivos manualmente.

Ao usar --tailwind, invoque a habilidade tailwind antes de editar classes ou tokens de tema. O scaffold usa Tailwind v4.2 via runtime do navegador, não a configuração Tailwind v3 do Studio.

Lint

npx hyperframes lint                  # diretório atual
npx hyperframes lint ./my-project     # projeto específico
npx hyperframes lint --verbose        # achados em nível informativo
npx hyperframes lint --json           # legível por máquina

Analisa index.html e todos os arquivos em compositions/. Reporta erros (devem ser corrigidos), avisos (devem ser corrigidos) e informações (com --verbose).

Inspeção Visual

npx hyperframes inspect                 # inspeciona o layout renderizado ao longo da timeline
npx hyperframes inspect ./my-project    # projeto específico
npx hyperframes inspect --json          # achados legíveis por agente
npx hyperframes inspect --samples 15    # varredura mais densa da timeline
npx hyperframes inspect --at 1.5,4,7.25 # timestamps explícitos de frames-herói

Use após lint e validate, especialmente para composições com balões de fala, cartões, legendas ou tipografia apertada. Ele reporta:

  • Texto que se estende para fora do contêiner visual ou balão mais próximo
  • Texto cortado por sua própria caixa de largura/altura fixa
  • Texto que se estende para fora do canvas da composição
  • Filhos escapando de contêineres com clipping

Erros devem ser corrigidos antes da renderização. Avisos são exibidos para revisão do agente; adicione --strict para falhar também em avisos. Problemas estáticos repetidos são colapsados por padrão para que a saída JSON permaneça compacta para janelas de contexto de LLM. Se o overflow for intencional para uma animação de entrada/saída, marque o elemento ou ancestral com data-layout-allow-overflow. Se um elemento decorativo nunca deve ser auditado, marque-o com data-layout-ignore.

npx hyperframes layout permanece disponível como um alias de compatibilidade para a mesma passagem de inspeção visual.

Pré-visualização

npx hyperframes preview                   # serve o diretório atual
npx hyperframes preview --port 4567       # porta personalizada (padrão 3002)

Recarrega automaticamente em alterações de arquivo. Abre o studio no navegador automaticamente.

Ao devolver um projeto ao usuário, use a URL do projeto do Studio, não o caminho do index.html fonte:

http://localhost:<port>/#project/<project-name>

Use a porta real da saída da pré-visualização e o nome do diretório do projeto. Por exemplo, após npx hyperframes preview --port 3017 em codex-openai-video, reporte http://localhost:3017/#project/codex-openai-video.

Trate index.html apenas como contexto de código-fonte. É aceitável vinculá-lo como um arquivo de implementação, mas não o rotule como projeto ou superfície de pré-visualização.

Renderização

npx hyperframes render                                # MP4 padrão
npx hyperframes render --output final.mp4             # saída nomeada
npx hyperframes render --quality draft                # iteração rápida
npx hyperframes render --fps 60 --quality high        # entrega final
npx hyperframes render --format webm                  # WebM transparente
npx hyperframes render --docker                       # byte-idêntico
FlagOpçõesPadrãoObservações
--outputcaminhorenders/nome_timestamp.mp4Caminho de saída
--fps24, 30, 603060fps dobra o tempo de renderização
--qualitydraft, standard, highstandarddraft para iterações
--formatmp4, webmmp4WebM suporta transparência
--workers1-8 ou autoautoCada um inicia uma instância do Chrome
--dockerflagdesligadoSaída reproduzível
--gpuflagdesligadoCodificação acelerada por GPU
--strictflagdesligadoFalha em erros de lint
--strict-allflagdesligadoFalha em erros E avisos
--variablesobjeto JSON—Substitui valores de variáveis declaradas em data-composition-variables
--variables-filecaminho—Arquivo JSON com valores de variáveis (alternativa ao --variables)
--strict-variablesflagdesligadoFalha na renderização se chaves não declaradas ou tipos incompatíveis em --variables

Orientação de qualidade: draft durante iterações, standard para revisão, high para entrega final.

Renderizações parametrizadas: a composição declara suas variáveis na raiz <html> com data-composition-variables — um array de declarações JSON ({id, type, label, default} por entrada) que define o esquema. Scripts internos leem os valores resolvidos via window.__hyperframes.getVariables(). A CLI --variables '{"title":"Q4 Report"}' é um objeto JSON indexado por id que substitui os padrões declarados para uma renderização; chaves ausentes seguem o padrão, então a mesma composição funciona inalterada na pré-visualização de desenvolvimento e em produção. (Hosts de sub-composições também podem substituir por instância com data-variable-values — mesma forma de objeto, com escopo para uma montagem da sub-composição. Veja a habilidade hyperframes para o padrão completo.)

Pré-processamento de Assets

npx hyperframes tts, transcribe e remove-background produzem assets (áudio de narração, transcrições palavra por palavra, vídeo transparente) que são inseridos em uma composição. Cada um baixa seu próprio modelo na primeira execução. Para seleção de voz, regras de modelo Whisper (a pegadinha do .en traduzir não-inglês), escolha de formato de saída (VP9 alpha WebM vs ProRes) e a cadeia TTS → transcrever → legendas, invoque a habilidade hyperframes-media.

Depuração

npx hyperframes doctor       # verificar ambiente (Chrome, FFmpeg, Node, memória)
npx hyperframes browser      # gerenciar Chrome incluído
npx hyperframes info         # detalhes da versão e ambiente
npx hyperframes upgrade      # verificar atualizações

Execute doctor primeiro se a renderização falhar. Problemas comuns: FFmpeg ausente, Chrome ausente, pouca memória.

Outros

npx hyperframes compositions   # listar composições no projeto
npx hyperframes docs           # abrir documentação
npx hyperframes benchmark .    # benchmark do desempenho de renderização

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.

Habilidades Relacionadas