Communitygithub.com

Elis3omndz/Claude_Skills

Adicione legendas ou subtítulos a um vídeo existente de uma única pessoa falando sem editar a gravação original. Use para legendas literais, legendas cinematográficas embutidas atrás do sujeito, legendas com efeitos VFX, legendas "炸/特效/酷炫" ou uma identidade nomeada do catálogo de 35 estilos. A rota é pela identidade visual, não pelo mecanismo interno. A trilha `anchor` silenciosa é o padrão; incorpore cada palavra apenas quando o usuário pedir explicitamente um tratamento totalmente cinematográfico. O fluxo de trabalho roda inteiramente localmente, incluindo transcrição e separação do sujeito; divida filmagens com vários planos antes de aplicar.

O que é Claude_Skills?

Este skill, **Embedded Captions**, adiciona legendas e subtítulos cinematográficos a vídeos de pessoas falando, sem modificar o vídeo original. Ele preserva a gravação intocada e sobrepõe texto de forma inteligente, usando um modelo de legenda que distingue entre texto descartável (preenchimentos), texto em trilha (rail - a maior parte da fala, em uma barra inferior padrão) e texto embutido (embed - palavra de destaque composta atrás do sujeito, com efeito de oclusão). O skill é especialmente útil para criadores de conteúdo, editores de vídeo e desenvolvedores que precisam de legendas de alta qualidade sem edição manual, suportando tanto legendas literais quanto tratamentos visuais complexos como os chamados "炸/特效/酷炫字幕" (efeitos VFX). Ele roda localmente, do início ao fim, usando ferramentas como FFmpeg, Sharp e Puppeteer para transcrição, separação do sujeito (matting) e renderização, e é compatível com ambientes de desenvolvimento como Claude Code, Cursor ou Codex. O fluxo de trabalho é guiado por um catálogo de 35 identidades visuais, onde o usuário escolhe uma identidade que determina o estilo das legendas, e o skill executa as etapas de preparação (matting e transcrição em paralelo), autoria criativa (um pequeno JSON), pré-visualização e renderização final. A principal inovação é o uso de uma trilha "âncora" padrão que mantém a maior parte do texto legível na frente, enquanto apenas uma ou duas palavras-chave por bloco são promovidas para o efeito embutido atrás do sujeito, evitando o erro comum de embutir cada palavra e preservando o impacto visual do clímax.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Elis3omndz/Claude_Skills/tree/HEAD/.claude/skills/embedded-captions

Perguntar na sua IA favorita

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

Documentação

Instalação de plugins: Antes de executar comandos de configuração ou atualização, siga as regras de execução de plugins quando este skill estiver dentro de um plugin HyperFrames. Instalações independentes mantenham as instruções de atualização abaixo.

Primeiro, mantenha este skill atualizado — confirme com o usuário antes de executar: npx hyperframes skills update embedded-captions. Um no-op rápido quando tudo está atualizado; caso contrário, ele atualiza este skill e os skills de domínio principais dos quais ele depende antes de você usá-los.

Legendas Embutidas (Embedded Captions)

Um catálogo, escolhido de início (CATALOG.md — 35 identidades; os mecanismos por trás são detalhes de implementação). Padrão (default) constrói uma trilha rail limpa e literal (legenda no terço inferior que carrega a maior parte do texto) + um clímax embed composto dentro da cena, atrás do sujeito no pico. Cinematográfico é puro embed — sem trilha rail, cada legenda composta atrás do sujeito (tipografia de destaque, acumulação, oclusão como efeito). Temático é uma constituição temática completa — paradigma corporal × peça de destaque × efeito frontal × reação da placa, composta a partir de registros (themes/README.md): ordnance terminal neonsign stardust stomp. A maioria das explicações / narrações usa o modo Padrão; embed é o pico escasso e merecido — embutir cada palavra é o erro comum; Temático é para pedidos de nível VFX ("炸", "特效", "como se fosse feito no AE").


Pré-requisitos de execução

Instalações de plugin usam a CLI agrupada e fixada no manifesto para separação de sujeito, transcrição e renderização; nenhum checkout de código-fonte é necessário. Os ajudantes de pré-visualização local e medição de legendas também precisam de Sharp, Puppeteer (com seu navegador Chromium) e GSAP. Instale-os no projeto de legendas, não dentro do plugin somente-leitura:

npm install --prefix <projeto> --save-dev --save-exact [email protected] [email protected] [email protected]

Mantenha o arquivo de lock do projeto. Se essas dependências já existirem, use suas versões travadas em vez de sobrescrevê-las. Bash e FFmpeg/ffprobe devem estar no PATH. A separação de sujeito e a transcrição podem baixar seus próprios modelos no primeiro uso.

A renderização aguarda a saída bem-sucedida da CLI antes de compor. O antigo watchdog de shell HF_TIMEOUT_S não é mais usado: um arquivo parcial grande não é prova de que a renderização terminou. Um argumento explícito de checkout construído ou HYPERFRAMES_ROOT seleciona a CLI do contribuidor em vez do pino do plugin. Cancele uma renderização travada normalmente através da CLI/terminal; o helper de legendas não força a interrupção nem recupera uma renderização a partir de um snapshot do processo.

Fluxo operacional (TL;DR)

Roteado através de /hyperframes, a camada de intenção confirma apenas a entrada (qual clipe) e anuncia a escolha da identidade como uma pergunta adiada — a lista de candidatos precisa do clipe sondado, então ela fica na etapa 1 abaixo; as perguntas de formato de execução da camada não se aplicam (a filmagem está intocada, não há storyboard para revisar). Um BRIEF.md, quando presente, carrega a entrada confirmada e quaisquer anotações do usuário — leia-o primeiro.

O texto de criação abaixo é longo; o pipeline em si é curto — e tudo que é determinístico é calculado ou compilado, nunca escrito à mão:

  1. Portão de decisão (recusar clipes ruins) → escolha UMA identidade de CATALOG.md (35 identidades; mecanismo/compilador derivado por consulta — nunca apresente uma pergunta de modo/categoria)
  2. hyperframes init (pule se o diretório do projeto já existir com o vídeo dentro — matte.cjs/transcribe.cjs adotam qualquer vídeo no diretório como source.mp4) → bash scripts/prepare.sh <projeto> (matte ∥ transcrição ∥ envelope de áudio em paralelo, depois zonas seguras v2 com paleta de cena/óptica/iluminação — um comando, nada esquecido)
  3. crie um pequeno JSON de escolhas criativas (leia safe-zones.json primeiro): Cinematográfico → cinematic.json → make-cinematic.cjs (deriva plan.json e o compila); Temático → theme.json → make-theme.cjs (paradigmas rail/panel/poem/takeover; anchor é o padrão da trilha silenciosa)
  4. QA Visual: node scripts/preview-frames.cjs <projeto> → pré-visualizações compostas fiéis em ~2s/quadro (sem renderizar). Verifique § QA Visual antes de pagar por uma renderização.
  5. render-and-composite.sh → portões (timing / oclusão+herói / estouro / hand-off) → final.mp4

Regras importantes que as pessoas ignoram:

  • trilha rail (padrão) + embed (promoção). drop (preenchimento, não exibido) / rail (legenda literal no terço inferior, na frente, carrega a maior parte do texto) / embed (uma palavra de pico composta atrás do sujeito). O modo Padrão faz ambos, embutindo apenas o(s) pico(s). Veja § Modelo de legenda.
  • O vídeo é entregue SEM ALTERAÇÕES (Padrão/Cinematográfico; o orçamento PLATE do modo Temático é a única exceção sancionada — batidas de reação com portão de registro (carga-dim, soco, tremor, granulação) definidas por DNA do tema e aplicadas APÓS a composição do matte para que sujeito+texto+placa se movam como um quadro) — legendas são a única coisa adicionada; o matte apenas permite que o sujeito oclua a trilha embed. Nunca gradear/recorrilinearize a filmagem.
  • Dois livros de regras: trilha rail → references/rail.md (fino), criação embed → references/composition-craft.md (rico, apenas embed). Folheie conforme necessário.

Modelo de legenda — rail + embed

Cada frase falada é uma de três coisas:

O que éComo é exibida
droppreenchimento — hum/ah, gaguejos, autocorreçõesnão exibido
railo padrão — conteúdo falado comum (literal)legenda limpa no terço inferior, na frente, legível. Uma palavra de destaque pode receber um destaque emphasis inline (cor de acento / pop de palavra ativa) — ela permanece na trilha rail.
embedum pico promovido — a batida principaluma palavra grande composta atrás do sujeito (oclusão do matte), entrada + saída projetadas

A trilha rail carrega a maior parte do texto; embed é o pico escasso e merecido. Escassez é por batida/bloco, não por clipe: ≤1 herói por bloco (pensamento), nunca dois co-visíveis, ≥ uma batida de ar entre janelas de herói (o compilador avisa abaixo de 0,6s). Um clipe curto → geralmente 1–2; uma explicação longa → ~um por seção. Entre vários heróis, o maior criado é o APEX (só ele recebe o embed completo de lockup + aumento de largura); os menores são picos MENORES que andam em sua coluna como linhas de ênfase superdimensionadas (fg, movimento amortecido) — nem toda batida precisa da vitrine do matte, que é exatamente o que mantém o apex como um evento. Embutir cada palavra ainda é o erro comum.

Identidades de superfície rail constroem exatamente isso (rail = rail.html, embed = o clímax em index.html). Identidades de fluxo de coluna descartam a trilha rail e tornam tudo estilo embed — recomende-as apenas para pedidos de humor sobre literalidade, nunca para explicações/narrações onde as palavras precisam ser lidas (CATALOG.md codifica isso por identidade).


Etapa 0 — escolha UMA identidade do CATÁLOGO

Um front-end, três mecanismos por trás. O usuário escolhe uma IDENTIDADE de CATALOG.md (35 entradas: 10 clássicas + 25 temáticas); o mecanismo, compilador e arquivo de autoria são derivados por consulta da linha do catálogo. Nunca apresente "Padrão vs Cinematográfico vs Temático" como uma pergunta — esses são nomes internos (um produto tem uma UX mesmo com vários mecanismos). O catálogo codifica tudo que o roteamento precisa: superfície de leitura, voz, recomendar-para, necessidades de cena, notas de adjacência para os pares realmente próximos (loud↔ordnance, neon↔neonsign, cream↔stardust).

A escolha da identidade é um portão de preferência (../hyperframes/references/brief-contract.md § 1): em modo autônomo ("surpreenda-me" / "decida por mim"), escolha da sua lista de candidatos você mesmo e declare o motivo em uma linha em vez de perguntar.

Procedimento: sonde o clipe → liste 2–3 identidades do catálogo → recomende UMA com um motivo em uma linha → o usuário escolhe (modo autônomo: você escolhe, declarando o motivo) → crie o arquivo dessa identidade. Identidades são travadas por mecanismo (sem combos cruzados; abrir uma é um evento de validação — veja dna/README.md).

Sempre apresente sua recomendação e deixe o usuário escolher antes de criar. Não use um padrão silenciosamente.

(A tabela completa de identidades está em CATALOG.md — fonte única da verdade para roteamento. Os documentos do mecanismo abaixo descrevem o contrato de autoria de cada backend.)

CATALOG.md é todo o espaço de respostas aqui: este fluxo de trabalho não pesquisa o registro de componentes HyperFrames. Os fluxos de trabalho de composição executam npx hyperframes catalog antes de criar um visual nomeado; este não deve. Seus mecanismos são compiladores travados que consomem cinematic.json / theme.json e emitem a composição eles mesmos, então um item do registro — os blocos caption-* incluídos — não tem nada onde montar. Um bloco de registro estiliza texto em uma tela projetada; este skill queima legendas na filmagem de alguém através de um matte. Quando nenhuma identidade se encaixa no pedido, diga isso e escolha a mais próxima, em vez de procurar fora do catálogo.

Heurística de recomendação: use as "Heurísticas de listagem" em CATALOG.md — elas são no nível da identidade (ex.: "炸" lista ordnance/stomp/terminal/loud e escolhe pelo QUE deve explodir), nunca no nível de categoria. Em dúvida → anchor.

  • Cinematográfico → escreva cinematic.json para um template travado, compilado por make-cinematic.cjs.
  • Temático → leia themes/README.md, crie theme.json, execute scripts/render-theme.sh (compila + renderiza + reação da placa → final_fx.mp4).

Portão de decisão — EXECUTE PRIMEIRO

Sonde o vídeo e classifique a cena antes de qualquer modo.

ffprobe <video.mp4>                    # especificações
ffmpeg -ss <t> -i <video.mp4> -vframes 1 sample.png   # em 20/50/80%

Leia as amostras. Recuse se:

  • Múltiplos falantes / cortes bruscos (divida e renderize cada plano, ou recuse)
  • Nenhum sujeito humano (este skill é para pessoa falando)
  • Menos de 3 segundos, sem fala, ou rosto nunca claramente visível — transcribe.cjs avisa quando o áudio está quase silencioso (Whisper alucina palavras como "Obrigado." sobre o silêncio); obedeça e recuse em vez de legendas de palavras fabricadas
  • A fonte já tem legendas/legendas embutidas / gráficos de texto pesados — adicionar um segundo sistema de legendas conflita e a filmagem é entregue intocada (sem cobrir/inpaint). Texto queimado geralmente aparece apenas no meio do clipe: amostre uma folha de contato de 1fps (ffmpeg -i in.mp4 -vf "fps=1,scale=160:-1,tile=10x5" sheet.png), não confie em 3 quadros de ponto.
  • A transcrição é lixo — fala não-nativa/com sotaque pesado pode ser transcrita em um absurdo confiante. Leia transcript.json com sanidade antes de criar; se não fizer sentido como linguagem, tente WHISPER_MODEL=medium uma vez, senão recuse (uma trilha rail literal de palavras fabricadas é pior do que sem legendas).
  • Câmera na mão ocupada com movimento rápido (matte tremula)

Sondagens pré-voo (não custam nada, previnem as piores falhas)

  1. Sondagem de corte de plano. Amostre quadros em 20%, 50%, 80%. Se um sujeito/cena diferente aparecer, apare o clipe antes do corte.
  2. Sondagem de letterbox / pillarbox. Barras pretas no primeiro quadro? Calcule o retângulo de conteúdo seguro e restrinja a colocação da legenda dentro dele.
  3. Sondagem de luminância. Amostre a luminância média da região da legenda — abaixo de 60 → texto claro lê-se como está, 60-180 → adicione o scrim de glifo, 180+ → texto opaco + scrim (nunca texto claro puro). Templates cinematográficos são cream+screen e TRAVADOS — use esta sonda para escolher uma identidade adequada (cenas claras → ink, ou o tema anchor de trilha opaca), nunca para recolorir uma.
  4. Recomendação de identidade por tom (você recomenda; o usuário escolhe — veja Etapa 0 + CATALOG.md). explicação / entrevista / palavras devem ser lidas → identidades de superfície rail/panel; poético / social / "cinematográfico" → identidades de fluxo de coluna por registro; "炸 / 特效 / VFX" / mundos nomeados → identidades temáticas. Em dúvida → anchor (palavras lidas, cena segura) — mas apresente uma lista de candidatos e deixe o usuário escolher.

Pipeline — 5 etapas

1. hyperframes init <projeto> --non-interactive --video <video.mp4> --skill=embedded-captions
2. bash scripts/prepare.sh <projeto>       # matte ∥ transcrição (paralelo) → zonas seguras. Um comando.
                                           #   → frames_fg/ transcript.json safe-zones.json
3. [ETAPA DO AGENTE — a única etapa criativa] crie um pequeno JSON; veja abaixo por modo
   Cinematográfico: crie cinematic.json → node scripts/make-cinematic.cjs <projeto>
   Temático:     crie theme.json → bash scripts/render-theme.sh <projeto>   (compila + renderiza + efeitos de placa)
4. node scripts/preview-frames.cjs <projeto>   # ~2s/quadro pré-visualizações compostas → § QA Visual (ANTES da renderização)
5. bash scripts/render-and-composite.sh <projeto>  # portões → final.mp4 + snapshot history/
   (Modo Temático: PULE as etapas 3b/5 — render-theme.sh já executa compilação + render-and-composite
    + _postfx.sh; o entregável é final_fx.mp4, final.mp4 é pré-reação da placa)

O init da etapa 1 verifica os skills instalados contra os mais recentes no GitHub e atualiza o conjunto global se algum estiver desatualizado.

A etapa 3 difere por modo:

Etapa 3 — Modo Cinematográfico (embed puro)

  1. Leia safe-zones.json primeiro. Planos de narração vão em zones.hugLeft/hugRight — faixas limpas JUSTAPOSTAS à silhueta (texto longe do corpo parece flutuante, não embutido; cantos distantes são o fallback, não o padrão). O herói padrão é heroAnchor/heroBands.best (centralizado NO sujeito, ~30–55% ocluído). recommendation:"fg" move a NARRAÇÃO para a frente para legibilidade; o herói permanece embutido sempre que heroBands.feasible — herói-fg é o último recurso.
  2. O DNA é a identidade que você escolheu na Etapa 0

Individual skills in this repo

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

Elis3omndz/Claude_Skills

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

Elis3omndz/Claude_Skills

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). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

Elis3omndz/Claude_Skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

Elis3omndz/Claude_Skills

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Elis3omndz/Claude_Skills

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`.

Elis3omndz/Claude_Skills

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

Elis3omndz/Claude_Skills

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

Elis3omndz/Claude_Skills

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Elis3omndz/Claude_Skills

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

Habilidades Relacionadas