Communitygithub.com

DigitalRavagers/Experiment

Workflow de PR para vídeo - uma Pull Request do GitHub (URL como github.com/<owner>/<repo>/pull/<N>, ou <owner>/<repo>#<N>, ou "esta PR" em um repositório com checkout) resulta em fatos ingeridos da PR (título, corpo, diff, commits, arquivos, estatísticas +/-) -> narrator_scripts.json + áudio (voz + música de fundo) + section_plan.md -> vídeo explicativo com code-diff / antes-depois / impacto. A entrada é uma MUDANÇA DE CÓDIGO. A URL é um link de PR, NÃO um site de marketing para scraping; não é um resumo de texto nem um site de produto. Para entradas que não são PR (site de produto, site genérico, texto sobre um tópico), consulte /hyperframes.

O que é Experiment?

Esta skill transforma uma Pull Request do GitHub em um vídeo explicativo detalhado sobre a mudança de código. Ela extrai automaticamente os dados da PR via CLI `gh`, incluindo título, corpo, diff, commits, arquivos alterados, e estatísticas de adições/remoções, além de informações sobre autores e revisores. A partir desses dados, a skill gera um roteiro de narração, áudio com voz e música de fundo (usando HeyGen, ElevenLabs ou Kokoro como fallback local), e um plano visual de seções. O resultado final é um vídeo no estilo editorial 'claude' (com paleta de cores navy e janelas de código) que explica o que foi enviado, por que e como funciona, ideal para changelogs, revisões de código ou demonstrações de features. A skill é parte do ecossistema Hyperframes, suporta execução local (macOS Apple Silicon ou Linux x64) e requer a CLI `gh` autenticada para ingestão de dados.

Funciona com✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/DigitalRavagers/Experiment/tree/HEAD/.agents/skills/pr-to-video

Perguntar na sua IA favorita

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

Documentação

pr-to-video - ponto de entrada de despacho

A entrada é uma Pull Request do GitHub (uma mudança de código), fornecida como uma URL de PR, uma referência <owner>/<repo>#<N>, ou "esta PR" enquanto um repositório com uma PR aberta está em checkout. A saída é um vídeo explicativo da mudança de código: o que foi enviado, por que, e como funciona — renderizado a partir do diff/commits como cenas de antes-depois, destaque de diff, árvore de arquivos e impacto. Duração padrão de até ~3 min (ponto ideal ~30-90s); uma apresentação genuinamente mais longa ou exaustiva de cada arquivo (5 min+) é um registro diferente → /general-video. Não há scraping de site e nem Chrome headless para ingestão — a ingestão é feita pela CLI gh. O preset de estilo enviado é sempre claude (editorial acolhedor; janela de código azul-marinho característica).

Confirme a rota antes do Passo 0. Esta skill explica uma Pull Request do GitHub (uma mudança de código lida via gh). Se a entrada for um site de marketing / produto → /product-launch-video; um site genérico → /website-to-video; um tópico / artigo sem PR → /faceless-explainer; um tour de repositório inteiro ou release multi-PR → /general-video. Fora do escopo: dados ativos / em tempo de renderização — os fatos da PR são lidos uma vez no momento de autoria e incorporados. Se receber uma entrada que não seja PR, ou não tiver certeza? Leia /hyperframes primeiro.

Este fluxo de trabalho é dono apenas da parte específica da PR (ingestão + design da história); toda fase marcada como compartilhada reutiliza o mecanismo copiado do faceless-explainer inalterado (ele reside sob os próprios scripts/ + agents/ + phases/ desta skill, então <SKILL_DIR> resolve para pr-to-video).

Todos os artefatos vão para PROJECT_DIR = videos/<project-name>/ (criado no Passo 0); todos os caminhos abaixo são relativos a ele. O despacho é portável entre harnesses: antes do primeiro despacho de subagente, leia <SKILL_DIR>/../hyperframes-core/references/subagent-dispatch.md uma vez — ele mapeia os verbos de despacho (fan-out paralelo / background / wait) para os primitivos do seu harness; um limite de concorrência abaixo de N significa ondas do tamanho do limite, nunca menos workers. Este arquivo é um runbook vinculante, não leitura de fundo: execute os passos em ordem e produza cada artefato de fase com seu script designado ou papel de agente — não substitua por um pipeline livre, e não pule um passo de pausa porque o pedido parece claro. Um passo que você não pode executar → pare e relate.

FaseExecuçãoArtefato principalFluxo detalhado
initBashhyperframes.jsonPasso 0
ingest (própria)Bash (CLI gh + ingest.mjs + fetch-people-avatars.mjs, SEM agente, SEM scraping)capture/pr.json + diff.patch + extracted/{tokens.json,visible-text.txt,people.json} + public/avatars/Passo 1
design-system (compartilhada)Bash (sem agente, claude determinístico)design-system/design.html + chunks/Passo 1b
story-design (própria)subagentenarrator_scripts.jsonagents/story-design.md
áudio (compartilhada)audio.mjs no Bashaudio_meta.jsonphases/audio/guide.md
visual-design (compartilhada)subagentesection_plan.mdagents/visual-design.md
prep (compartilhada)prep.mjs no Bashgroup_spec.jsonscripts/prep.mjs
legendas (compartilhada, detalhada)captions.mjs group -> captions.mjs html no Bash (sem subagente)caption_groups.json + compositions/captions.htmlscripts/captions.mjs
cenas (compartilhada)N x subagente (paralelo)compositions/scene_*.html ou compositions/group_w*.htmlagents/hyperframes-scene.md
finalizar (compartilhada)Prelúdio Bash (wait-bgm + montar + injetar/verificar transições + hoist-videos + sfx-verify + preflight) -> subagente finalizar (corrigir achados breves no local + uma olhada enxuta de contato + renderizar)renders/video.mp4Passo 7 / agents/hyperframes-finalize.md

Pré-requisitos

macOS Apple Silicon ou Linux x64. Ferramentas do sistema: brew install [email protected] node ffmpeg (use Homebrew Python, não /usr/bin/python3, ou pip install será bloqueado pelo PEP 668); depois npx hyperframes doctor uma vez (baixa o Chrome — necessário para snapshot/render, não para ingestão). O gate de sobreposição renderizado (scripts/check-overlap.mjs, executado em auto-verificações de worker e preflight) reutiliza o mesmo Chrome em cache — ele nunca baixa um navegador; sua única dependência é o módulo npm puppeteer-core, garantido uma vez antes do fan-out de cenas (Passo 5.5, --ensure-deps, ~5s, sem instalação completa de puppeteer). CLIs: gh (GitHub CLI, autenticado — gh auth status deve passar) e hyperframes. Chaves de nuvem opcionais (senão fallbacks locais) — injete no Passo 0.5:

Chave / requisitoUsado paraPadrão / fallback
gh auth status OKLer a PR (pública ou privada)obrigatório — falhe rápido com a dica de autenticação
HEYGEN_API_KEY (ou hyperframes auth login)TTS (nuvem, timestamps em nível de palavra)voz: auto (primeira voz starfish em inglês; sobrescreva com --voice)
ELEVENLABS_API_KEYTTS (nuvem; precisa de pip install elevenlabs)voz 21m00Tcm4TlvDq8ikWAM (Rachel)
nenhuma, e não logadoTTSKokoro local, voz am_michael (não inglês: passe --voice)
GEMINI_API_KEY / GOOGLE_API_KEY (alias)Música de fundo Lyrianão definido -> MusicGen local (primeira execução baixa ~300 MB)

Fluxo

Passo 0.0 - Confirme o briefing (SEMPRE pergunte uma rodada, depois construa)

Antes do Passo 0, sempre pause e pergunte o briefing em uma mensagem, depois aguarde o usuário — nunca pule isso, mesmo para um pedido que pareça completo. Lidere com um padrão recomendado para cada campo e pré-preencha qualquer coisa que o usuário já deu (confirme em vez de perguntar cegamente): o ângulo (changelog / revelação de funcionalidade / correção / refatoração — padrão: inferir da PR), o público (desenvolvedores vs usuários gerais — padrão: desenvolvedores), duração (padrão ~60-90s), e — se /hyperframes não os definiu — aspecto (padrão 16:9) e idioma. O estilo é sempre claude. Prossiga para o Passo 0 somente após o usuário responder; uma resposta "vai" / "use os padrões" é uma resposta válida que aceita todos os padrões.

Passo 0 - Inicialize o projeto de vídeo

cwd é a raiz do workspace do agente (ex.: /tmp/pr-video-...). Escreva todos os artefatos de vídeo sob PROJECT_DIR = videos/<project-name>/.

<project-name>: use o diretório que o usuário deu (ex.: Use ./videos/retry-pr), senão um nome curto em kebab-case derivado da PR (<repo>-pr-<N>, ex.: widgets-pr-1187). Não o nome base do workspace ou um timestamp.

Apenas quando $PROJECT_DIR/hyperframes.json estiver ausente:

PROJECT_DIR="${PR_VIDEO_DIR:-videos/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --skip-skills --example=blank

hyperframes init coloca um AGENTS.md / CLAUDE.md genérico em $PROJECT_DIR; deixe-os no lugar — são andaimes de agente para quem abrir o projeto finalizado depois.

Restrições: nunca execute hyperframes init / gere AGENTS.md / CLAUDE.md na raiz do workspace; nunca aninhe outro hyperframes/ dentro de PROJECT_DIR; todo comando Bash (master + subagentes) é um subshell (cd "$PROJECT_DIR" && ...) — nunca cd puro.

Passo 0.5 - Orientação de chaves de API

Pule se $PROJECT_DIR/.env existir ou context.log não estiver vazio (= não é a primeira execução). Caso contrário, primeiro detecte o que está disponível (HeyGen TTS ligado se $HEYGEN_API_KEY / $HYPERFRAMES_API_KEY definido ou ~/.heygen/credentials existir de hyperframes auth login; ElevenLabs / Gemini apenas se suas chaves de ambiente estiverem definidas), depois sempre pause e ofereça o menu — aguarde o usuário; não prossiga por conta própria mesmo quando uma configuração funcional for detectada (o usuário pode querer adicionar uma chave como Gemini). Informe o que foi detectado, depois: cole chaves (→ Escreva $PROJECT_DIR/.env, uma CHAVE=valor por linha, sobrescreva mesmo nome) / "vai" (prossiga com o que está configurado — env, .env, ou hyperframes auth login) / "pular" (prossiga com fallbacks locais para qualquer coisa não configurada). Depois prossiga para o Passo 1.

Passo 1 - Ingestão (Bash, SEM agente, SEM scraping)

Resolva a referência da PR e extraia fatos estruturados com gh, depois dobre-os no pacote de captura sintético que o backend compartilhado espera (espelha o scaffold sem scraping do faceless-explainer). gh é executado aqui, no orquestrador, então erros de autenticação / não encontrado / repositório privado aparecem com o stderr do próprio gh; ingest.mjs é uma transformação puramente offline.

# Referência da PR: uma URL completa, "<owner>/<repo>#<N>", ou "<N>" dentro de um repositório com checkout.
PR="<url | owner/repo#N | N>"

# Falhe rápido se gh não estiver autenticado.
gh auth status || { echo "gh não autenticado — execute: gh auth login"; exit 1; }

(cd "$PROJECT_DIR" && mkdir -p capture/extracted capture/assets)
(cd "$PROJECT_DIR" && gh pr view "$PR" \
  --json number,title,body,author,url,baseRefName,headRefName,commits,files,additions,deletions,changedFiles,labels,reviews,latestReviews,comments,assignees,reviewDecision,mergedBy \
  > capture/pr.json)
(cd "$PROJECT_DIR" && gh pr diff "$PR" > capture/diff.patch)

# Dobre pr.json + diff.patch em tokens.json (colors:[] → paleta nativa claude) +
# visible-text.txt (o resumo narrativo) + people.json (autor da PR + autores de commits com contagens +
# revisores / comentadores / designados, filtrados por bot + deduplicados, cada um com URL de avatar do GitHub).
# (O `author` da PR é apenas o abridor; autores de commits de commits[].authors[] também são rastreados.)
# ingest é OFFLINE.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/ingest.mjs \
  --pr-json ./capture/pr.json --diff ./capture/diff.patch --out-dir ./capture/extracted)

# Etapa de rede (a única da frente de pessoas — ingestão permanece offline): baixe
# o avatar do GitHub de cada contribuidor para public/avatars/<login>.png para um encerramento opcional
# de créditos / enviado por. Melhor esforço — um avatar ausente ou execução offline nunca bloqueia (exit 0).
# Avatares + esse encerramento são o ÚNICO lugar onde pr-to-video relaxa o padrão faceless.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
  --people ./capture/extracted/people.json)

Validação:

[ -s "$PROJECT_DIR/capture/pr.json" ] && \
[ -s "$PROJECT_DIR/capture/diff.patch" ] && \
[ -s "$PROJECT_DIR/capture/extracted/tokens.json" ] && \
[ -s "$PROJECT_DIR/capture/extracted/visible-text.txt" ] && \
[ -s "$PROJECT_DIR/capture/extracted/people.json" ] && \
[ -d "$PROJECT_DIR/capture/assets" ] && echo ok || echo faltando
# public/avatars/ é melhor esforço — sua ausência NÃO é uma falha (nenhum avatar resolvido / offline).

Se gh errar (autenticação / não encontrado / privado), relate o stderr exato e pare — não invente conteúdos da PR. Se ingest.mjs sair

…

[truncado para tradução]

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 CLI dev loop. Use when running 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, or remove-background, or when troubleshooting the HyperFrames build/render environment. Entry point for AWS Lambda cloud rendering (`hyperframes lambda deploy / render / progress / destroy / policies`).

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

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