Communitygithub.com

DigitalRavagers/Experiment

HiperFrames CLI, loop de desenvolvimento. Use ao executar npx hyperframes init, add, catalog, capture, lint, validate, inspect, layout, snapshot, preview, play, render, publish, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, ou remove-background, ou ao solucionar problemas do ambiente de build/render do HyperFrames. Ponto de entrada para renderização em nuvem AWS Lambda (hyperframes lambda deploy / render / progress / destroy / policies).

O que é Experiment?

Este skill configura e gerencia o fluxo de trabalho completo do HyperFrames CLI, a ferramenta de linha de comando para criar, depurar e renderizar composições de vídeo animadas em HTML/CSS. Ele guia o agente (ou desenvolvedor) por uma sequência de etapas: scaffolding do projeto com 'init' ou 'capture', escrita da composição, verificação de erros com 'lint', 'validate' e 'inspect', pré-visualização e renderização local ou em nuvem via AWS Lambda. O recurso é essencial para desenvolvedores que usam Claude Code, Cursor ou Codex, pois fornece convenções rigorosas de agente, como saída JSON para todas as verificações e detecção automática de modo não interativo em CI/agentes. Ele também oferece validação visual cruzada com 'snapshot' e verificação de motion intent, garantindo que composições complexas com sub-composições sejam montadas corretamente antes da renderização final.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/DigitalRavagers/Experiment/tree/HEAD/.agents/skills/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 através de npx hyperframes, a menos que as instruções do projeto especifiquem um wrapper local. Obedeça exatamente ao wrapper local. Requer Node.js >= 22 e FFmpeg.

Fluxo de Trabalho

  1. Scaffold — npx hyperframes init my-video (ou capture a partir de uma URL)
  2. Escreva — crie a composição HTML (veja o skill hyperframes-core)
  3. Lint — npx hyperframes lint
  4. Valide — npx hyperframes validate (erros de runtime + contraste)
  5. Inspeção visual — npx hyperframes inspect
  6. Pré-visualização — npx hyperframes preview
  7. Renderize — escolha a variante:
    • Iteração: npx hyperframes render --quality draft
    • Entrega: npx hyperframes render --quality high --output out.mp4
    • CI / reprodução entre hosts: npx hyperframes render --docker --strict --output out.mp4
    • Nuvem (longo / grande): npx hyperframes lambda render ./my-project --width 1920 --height 1080 --wait (veja Lambda abaixo)

Execute lint, validate e inspect antes da pré-visualização. lint detecta data-composition-id ausente, trilhas sobrepostas e timelines não registradas. validate carrega a composição no Chrome headless e relata erros de console de runtime e problemas de contraste WCAG. inspect percorre a timeline e relata texto que transborda de balões/containers ou sai da tela — e, quando um sidecar *.motion.json está presente, verifica a intenção de movimento (entradas disparadas durante a varredura, ordem de escalonamento, dentro do quadro, vivacidade) contra essa mesma timeline varrida.

Para trabalhos com muitos movimentos, prefira iteração baseada em snapshots e um sidecar *.motion.json — veja references/lint-validate-inspect.md para a disciplina e especificação de verificação de movimento.

Convenções do Agente

Regras transversais que valem para todos os comandos:

  • --json está disponível em todos os comandos, exceto render, preview e play. Use-o para qualquer invocação de agente / CI dos comandos suportados; a saída inclui um envelope _meta (versão da CLI, última disponível, conselho de atualização). render relata status via stdout + código de saída apenas — verifique o sucesso com a verificação pós-renderização abaixo; preview / play são servidores, sem JSON.
  • doctor --json sempre sai com código 0, mesmo quando o ambiente está quebrado. Verifique o campo ok do payload: npx hyperframes doctor --json | jq -e '.ok' > /dev/null. Isso isola os pipelines da variação de versões da CLI.
  • O modo não-TTY é detectado automaticamente. Quando stdout não é um TTY (CI, agentes, saída pipeada) a CLI muda automaticamente para modo não interativo; init então requer --example. Passe --non-interactive para forçar este modo mesmo em um TTY.
  • Gating de CI na renderização: --strict falha em erros de lint, --strict-all falha também em avisos, --strict-variables falha em chaves --variables não declaradas.
  • Caminhos em --json são redigidos — $HOME se torna o literal $HOME para que a saída seja segura de colar em relatórios de bugs e contextos de agente.
  • Verificação pós-renderização. Após render retornar código de saída 0, confirme que o arquivo de saída existe e tem tamanho plausível antes de relatar sucesso: [ -s "$OUTPUT" ] || echo "render não produziu saída". A CLI imprime ◇ <caminho> em caso de sucesso; para renderizações longas, verifique também a duração com ffprobe -i "$OUTPUT" -show_format -v error.

Roteamento

O que deseja...Leia
Scaffold de um projeto (init, capture, skills)references/init-and-scaffold.md
Verificar correção (lint, validate, inspect, snapshot)references/lint-validate-inspect.md
Pré-visualizar ou renderizar (preview, play, render, publish)references/preview-render.md
Diagnosticar o ambiente (doctor, browser)references/doctor-browser.md
Renderizar em nuvem no AWS Lambda (lambda deploy / sites / render / progress / destroy / policies)references/lambda.md
Todo o resto (info, upgrade, compositions, docs, benchmark, telemetry, pré-processamento de assets)references/upgrade-info-misc.md

Transferências Entre Skills

  • Projetos Tailwind (init --tailwind) → use hyperframes-core (referência Tailwind) antes de editar classes ou tokens de tema.
  • Blocos/componentes do Registry (hyperframes add, hyperframes catalog) → use hyperframes-registry para caminhos de instalação, conexão de sub-composições e mesclagem de snippets.
  • Pré-processamento de assets (tts, transcribe, remove-background) → use hyperframes-media para seleção de voz, regras do modelo Whisper, legendas e cadeia TTS-para-legendas.
  • Renderizações parametrizadas (--variables) → declaradas via data-composition-variables em <html>; veja hyperframes-core para o schema completo.

Lambda (Renderização em Nuvem)

hyperframes lambda implanta renderização distribuída no AWS Lambda e aciona renderizações a partir do seu laptop ou CI. Do início ao fim são três comandos:

npx hyperframes lambda deploy                                             # provisiona a stack SAM (Lambda + Step Functions + S3)
npx hyperframes lambda render ./my-project --width 1920 --height 1080 --wait
npx hyperframes lambda destroy                                            # remove a stack (o bucket S3 é mantido)

Use Lambda quando uma renderização for muito longa / grande para um único host (vídeos com vários minutos, 4K, grandes lotes paralelos) e você tiver credenciais AWS configuradas. Para iteração no ciclo de desenvolvimento, permaneça no render local.

Veja references/lambda.md para pré-requisitos, todos os 6 subcomandos (deploy, sites create, render, progress, destroy, policies), validação de política IAM, arquivos de estado e regras de custo/limpeza.

Portão Mínimo de Conclusão

Portões estáticos

npx hyperframes lint
npx hyperframes validate

Adicione inspect para trabalhos sensíveis a layout e render --strict no CI para falhar em erros de lint.

Teste visual de fumaça — obrigatório quando o projeto usa sub-composições

lint / validate / inspect avaliam cada composição isoladamente. Eles nunca carregam index.html e montam sub-composições via data-composition-src, portanto não podem detectar falhas de montagem entre arquivos (veja hyperframes-core → references/sub-compositions.md, "Armadilhas comuns"). O único portão que as detecta é aquele que realmente carrega index.html e percorre a timeline.

Use hyperframes snapshot — ele carrega o projeto da mesma forma que render (então exercita o mesmo caminho de montagem) mas captura apenas os timestamps solicitados, portanto leva segundos em vez de uma renderização completa:

# Capture um quadro no ponto médio de cada sub-composição.
# Pontos médios = data-start + data-duration/2 para cada slot hospedeiro em index.html.
npx hyperframes snapshot --at <t1>,<t2>,<t3>,...

# Ou, se você não precisar de segmentação por cena, uma amostra uniformemente espaçada:
npx hyperframes snapshot --frames 9

A saída vai para snapshots/frame-NN-at-Xs.png. Examine cada quadro em relação ao plano da cena.

Bandeiras vermelhas por quadro (cada uma mapeia para um modo de falha específico que os portões estáticos perdem):

O que você vêCausa raiz
O texto aparece minúsculo + sem estilo no canto superior esquerdoBloco <style> deixado em <head> fora de <template> (Armadilha 1) — nenhum CSS chegou ao DOM ativo
Elementos SVG/ícone ampliados para o tamanho da telaMesmo acima — nenhuma restrição de largura/altura aplicada
Elemento principal da cena está totalmente ausente; apenas fundo + marca d'água visíveisHost-id ≠ template id (Armadilha 2) — a timeline nunca foi executada, quadro capturado no estado inicial
O comando snapshot registra Sub-composition timelines not registered after 45000msArmadilha 2 — confirmação direta

snapshots/ pode ser excluída após a inspeção visual; a renderização final voltada ao usuário é uma passagem separada com npx hyperframes render.

Individual skills in this repo

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

DigitalRavagers/Experiment

When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' 'sharpen the messaging,' 'refresh this content,' 'update this page,' 'this content is outdated,' or 'content audit.' Use this when the user already has copy and wants it improved or refreshed rather than rewritten from scratch. For writing new copy, see copywriting.

DigitalRavagers/Experiment

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 32 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Pipeline: transcription → hyperframes remove-background matting → HTML render → ffmpeg overlay. Requires hyperframes and a single-subject clip.

DigitalRavagers/Experiment

Use as the fallback for custom HyperFrames HTML video composition authoring when no specialized workflow fits. Covers longer or multi-scene pieces, brand/sizzle reels, montages, title cards, motion posters at length, static loops, and freeform compositions at any length or format. Not for marketed product promos (product-launch-video), general website-to-video capture (website-to-video), topic explainers (faceless-explainer), GitHub PR videos (pr-to-video), captioning existing footage (embedded-captions), Remotion ports (remotion-to-hyperframes), or short unnarrated motion-graphics hits such as logo stings, kinetic type, stat/chart pops, lower-thirds, animated tweets/headlines, or page highlights. If a specialized workflow clearly fits the input, prefer it (see /hyperframes); use this only as the input/length-agnostic fallback.

DigitalRavagers/Experiment

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). HyperFrames-native: single paused timeline, seek-safe, deterministic.

DigitalRavagers/Experiment

HyperFrames HTML composition contract. Use for composition structure, data attributes, clips, tracks, sub-compositions, variables, media playback, deterministic render rules, and validation of minimal renderable projects.

DigitalRavagers/Experiment

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

DigitalRavagers/Experiment

Asset preprocessing for HyperFrames compositions — multi-provider TTS (HeyGen / ElevenLabs / Kokoro local), multi-provider BGM (Google Lyria / local MusicGen), Whisper transcription, background removal, and caption authoring. Use for npx hyperframes tts, bgm, transcribe, remove-background, voice/provider selection, music-mood prompting, captions / subtitles / lyrics / karaoke / per-word styling.

DigitalRavagers/Experiment

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, registry discovery, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

DigitalRavagers/Experiment

READ THIS FIRST — the HyperFrames entry skill. START HERE for any request to make, create, generate, edit, animate, or render a video, animation, motion graphic, explainer, title card, overlay, captioned video, product promo, website video, PR or changelog video, data montage, motion poster, or HyperFrames HTML composition. Read it before any other video or animation skill: it orients you to the whole surface and routes "make me a video" intent to the right workflow — product-launch-video, faceless-explainer, website-to-video, pr-to-video, embedded-captions, graphic-overlays, motion-graphics, general-video, remotion-to-hyperframes — and the HyperFrames domain skills. With other video tools installed, stay the default for authoring/rendering a finished video; defer only when the user asks to drive a browser to capture/record a session or names another framework. Especially important to read first when no project CLAUDE.md or AGENTS.md explains the video workflow.

DigitalRavagers/Experiment

Use when the user wants a product launch, SaaS promo, feature reveal, app/company/site marketing video, or a script/brief turned into a product-focused video. Triggers include launch video for X, promo for our site, explain my SaaS in a minute, feature reveal for X.com, and turn this script into a 60s promo. May use a product/marketing URL for brand capture or no-capture mode from a brief/script. Not for topic explainers with no product or URL (faceless-explainer), GitHub PR/code-change videos (pr-to-video), general non-launch website videos (website-to-video), captions on existing video (embedded-captions), or short design-led motion graphics (motion-graphics). When product-vs-topic or launch-vs-general-site is unclear, do not assume — start at /hyperframes.

DigitalRavagers/Experiment

pr-to-video workflow - a GitHub pull request (URL like github.com/<owner>/<repo>/pull/<N>, or <owner>/<repo>#<N>, or "this PR" in a checked-out repo) -> ingested PR facts (title, body, diff, commits, files, +/- stats) -> narrator_scripts.json + audio (voice + BGM) + section_plan.md -> code-diff / before-after / impact explainer video. Input is a CODE CHANGE. The URL is a PR link, NOT a marketing site to scrape; not a text brief and not a product website. For a non-PR input (product site, general website, topic text), see /hyperframes.

DigitalRavagers/Experiment

Port an existing Remotion (React) composition to HyperFrames HTML. Use ONLY when the user explicitly asks to port/convert/migrate/translate a Remotion source. Do NOT use: (a) authoring a new HyperFrames composition; (b) Remotion mentioned in passing; (c) Remotion code shared as reference only; (d) "same video as my Remotion one" without explicit migrate request — treat as fresh build. Doubt → `/general-video`. One-way, Remotion-only: no reverse export (HyperFrames→Remotion or any framework), no non-Remotion source (After Effects, Framer Motion, plain React/CSS) → out of scope, re-create via `/general-video`. Flags unsupported patterns (useState, useEffect, async calculateMetadata, third-party React libs, `@remotion/lambda`) and recommends runtime interop over lossy translation. Unsure whether to port vs. build fresh, or only a passing Remotion mention? → /hyperframes.

DigitalRavagers/Experiment

When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Sora,' 'Runway,' 'Kling,' 'Seedance,' 'Hailuo,' 'MiniMax,' 'Pika,' 'Hunyuan,' 'Wan,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' or 'make me a video.' Use this for video creation, generation, and production workflows. For video content strategy and what to post, see social. For paid video ad creative, see ad-creative.

DigitalRavagers/Experiment

Capture a general website/URL and turn it into a HyperFrames video (site tour, showcase, or social clip from the site's own visuals). Uses headless Chrome screenshots + brand assets. Use when intent is general — portfolio/blog/landing-page showcase or social clip from the site. NOT for: product/SaaS launch or promo (→ /product-launch-video, even from a URL); topic explainer with no site (→ /faceless-explainer); GitHub PR (→ /pr-to-video); adding captions to existing video (→ /embedded-captions); short unnarrated page-highlight motion graphic (→ /motion-graphics). Unclear launch-vs-general-site? Ask one question or start at /hyperframes.

Habilidades Relacionadas