Communitygithub.com

Biznomad/claude-skills

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

O que é claude-skills?

Esta skill descreve o loop de desenvolvimento completo para o HyperFrames CLI, uma ferramenta de linha de comando Node.js para criar composições de vídeo animadas (quadro a quadro) usando código. Ela suporta scaffolding de projetos (com exemplos), linting, inspeção visual, pré-visualização com hot-reload e renderização de saída MP4/WebM. O linting detecta erros como IDs de composição ausentes e sobreposição de trilhas; a inspeção visual relata texto vazando de balões ou containers; a renderização é parametrizável e suporta renderização em Docker. A skill também inclui comandos de ambiente (`doctor`, `browser`, `info`, `upgrade`) para solucionar problemas comuns como FFmpeg ou Chrome ausentes. É ideal para desenvolvedores e agentes de IA que trabalham com o ecossistema HyperFrames.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Biznomad/claude-skills/tree/HEAD/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 roda através de npx hyperframes. Requer Node.js >= 22 e FFmpeg.

Fluxo de Trabalho

  1. Scaffold — npx hyperframes init my-video
  2. Escrever — criar composição HTML (veja a skill hyperframes)
  3. Lint — npx hyperframes lint
  4. Inspeção visual — npx hyperframes inspect
  5. Pré-visualização — npx hyperframes preview
  6. Renderização — npx hyperframes render

Execute lint e inspeção antes da pré-visualização. lint detecta data-composition-id ausente, trilhas sobrepostas e timelines não registradas. inspect abre a composição renderizada no Chrome headless, percorre a timeline e relata texto vazando para fora de balões/containers 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 runtime do navegador
npx hyperframes init my-video --non-interactive       # pular prompts (CI/agentes)

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

init cria a estrutura de arquivos correta, copia mídia, transcreve áudio com Whisper e instala skills de IA. Use em vez de criar arquivos manualmente.

Ao usar --tailwind, invoque a skill 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.

Linting

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

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

Inspeção Visual

npx hyperframes inspect                 # inspeciona 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 hero-frame

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

  • Texto se estendendo para fora do container visual ou balão mais próximo
  • Texto cortado por sua própria caixa de largura/altura fixa
  • Texto se estendendo para fora do canvas da composição
  • Filhos escapando de containers de corte

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 LLM. Se o estouro 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                   # servir diretório atual
npx hyperframes preview --port 4567       # porta personalizada (padrão 3002)

Hot-reload em alterações de arquivo. Abre o studio no navegador automaticamente.

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

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

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

Trate index.html apenas como contexto de código-fonte. É aceitável vinculá-lo como arquivo de implementação, mas não o rotule como o 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ãoNotas
--outputcaminhorenders/nome_timestamp.mp4Caminho de saída
--fps24, 30, 603060fps dobra o tempo de renderização
--qualitydraft, standard, highstandarddraft para iterar
--formatmp4, webmmp4WebM suporta transparência
--workers1-8 or autoautoCada um inicia um Chrome
--dockerflagoffSaída reproduzível
--gpuflagoffCodificação acelerada por GPU
--strictflagoffFalha em erros de lint
--strict-allflagoffFalha 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 a --variables)
--strict-variablesflagoffFalha na renderização em chaves não declaradas ou incompatibilidades de tipo em --variables

Diretrizes de qualidade: draft durante a iteração, 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 JSON de declarações ({id, type, label, default} por entrada) que define o esquema. Scripts internos leem os valores resolvidos via window.__hyperframes.getVariables(). O CLI --variables '{"title":"Q4 Report"}' é um objeto JSON indexado por id que substitui os padrões declarados para uma renderização; chaves ausentes caem para o padrão, então a mesma composição roda inalterada na pré-visualização de desenvolvimento e em produção. (Hosts de sub-composição também podem substituir por instância com data-variable-values — mesma forma de objeto, com escopo limitado a uma montagem da sub-composição. Veja a skill 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 no nível de 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 do modelo Whisper (a pegadinha .en que traduz não-inglês), escolha do formato de saída (WebM alfa VP9 vs ProRes) e a cadeia TTS → transcrever → legendas, invoque a skill hyperframes-media.

Solução de Problemas

npx hyperframes doctor       # verificar ambiente (Chrome, FFmpeg, Node, memória)
npx hyperframes browser      # gerenciar Chrome empacotado
npx hyperframes info         # versão e detalhes do 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 .    # avaliar desempenho da renderização

Individual skills in this repo

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

Biznomad/claude-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/claude-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/claude-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/claude-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.

Biznomad/claude-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.

Biznomad/claude-skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

Biznomad/claude-skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

Biznomad/claude-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/claude-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/claude-skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

Biznomad/claude-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/claude-skills

Generate cinematic film-style video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants cinematic, film-like, movie-quality, Hollywood-style, dramatic, or professional film-quality AI video. Triggers on: cinematic, film look, movie scene, dramatic lighting, depth of field, lens flare, anamorphic, letterbox, noir, epic, Steadicam, dolly, crane shot, or any cinematic video generation request. Always use this skill even if the user doesn't explicitly say "cinematic" but describes a film-like aesthetic.

Biznomad/claude-skills

为 Seedance 2.0(Higgsfield)生成电影级胶片风格视频提示词。在用户想要电影级、胶片感、电影质量、好莱坞风格、戏剧性或专业胶片质量的AI视频时使用。触发词:电影级、胶片感、电影场景、戏剧性打光、景深、镜头光晕、变形、信箱式、黑色电影、史诗、稳定摄像机、推车镜头、吊臂镜头或任何电影级视频生成请求。即使用户没有明确说"电影级"但描述了胶片美学,也要使用此技能。

Biznomad/claude-skills

Convert comic book panels, manga pages, webtoons, and illustrated storyboards into animated video using Seedance 2.0 on Higgsfield. Use whenever the user wants to animate comics, bring illustrations to life, convert manga to video, animate storyboards, or create motion from static sequential art. Triggers on: comic to video, manga animation, panel animation, storyboard to video, webtoon animation, comic book motion, sequential art, graphic novel animation, or any illustrate-to-animate request. Use even when user says "make this drawing move" or "animate this page.

Biznomad/claude-skills

Generate music video and beat-synced visual content prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants to create a music video, lyric video, beat-synced visuals, performance video, concert visual, album art animation, or music-driven visual content. Triggers on: music video, lyric video, beat sync, music visualization, performance video, concert visual, album visual, song video, music clip, beat drop visual, rhythm sync, or any music-driven video request. Use even for "make visuals for my song" or "video for this track.

Biznomad/claude-skills

Build, redesign, and deploy websites across any stack — static HTML, Next.js, Astro, or Shopify Liquid themes. Handles design systems, brand-aware layouts, component architecture, and deployment pipelines (Netlify, Vercel, Shopify API). Use when asked to build a website, redesign a site, create a landing page, build a web app, create Shopify sections/templates, or deploy web projects. Triggers on requests like "build me a website", "redesign this page", "create a landing page", "build a Shopify theme", "deploy to Netlify".

Biznomad/claude-skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

Habilidades Relacionadas