Communitygithub.com

oiyi77/1ai-skills

Adiciona legendas/legendas ocultas a vídeos de cabeça falante ou vídeos de lançamento usando o HyperFrames. Utilize quando o usuário quiser legendas incorporadas, barras de legendas literais ou texto cinematográfico atrás do assunto. Abrange o modelo de legenda drop/rail/embed, a lei de sobreposição (legendas NÃO são uma faixa reservada), oclusão fosca para clímax incorporados e alinhamento de carimbo de data/hora de palavra a partir da saída de TTS.

O que é 1ai-skills?

Esta skill foca em adicionar legendas permanentemente queimadas (burned-in) a vídeos existentes através de uma composição de sobreposição do HyperFrames. É ideal para vídeos de cabeça falante, lançamentos de produtos ou conteúdo para redes sociais onde legendas acessíveis e estilizadas são necessárias sem a necessidade de um arquivo de legenda separado (SRT/VTT). A skill opera com um modelo de três níveis: **drop** (remove hesitações), **rail** (legenda padrão na parte inferior) e **embed** (palavra promovida atrás do sujeito para clímax). Uma regra fundamental é a 'Lei de Sobreposição', que determina que as legendas são compostas SOBRE o vídeo, não em uma zona reservada, exigindo que a composição seja centralizada verticalmente (y = H/2) e que o conteúdo possa se estender até a parte inferior do quadro. O fluxo de trabalho envolve gerar um voiceover com timestamps de palavra usando TTS, alinhar esses timestamps com tokens de exibição do script e, em seguida, construir a 'barra de legenda' (caption rail) no código. A verificação rigorosa inclui amostragem de quadros para garantir que as legendas estejam presentes e que a ortografia de exibição corresponda ao script. A skill é executada como um comando ou script dentro do ecossistema Node.js/HyperFrames.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/oyi77/1ai-skills/tree/HEAD/content/hyperframes-embedded-captions

Perguntar na sua IA favorita

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

Documentação

Visão Geral

Esta skill adiciona legendas queimadas a um vídeo existente através de uma composição de sobreposição do HyperFrames. Use-a quando sua filmagem de origem precisar de legendas acessíveis e estilizadas sem uma faixa de legenda separada. Ela renderiza o MP4 legendado deterministicamente a partir da sobreposição HTML.

HyperFrames — Legendas Incorporadas

Adicione legendas/legendas ocultas a vídeos de cabeça falante ou de lançamento. O modelo de legenda (drop/rail/embed) e a lei de sobreposição (legendas NÃO são uma faixa reservada).

Quando Usar

  • O usuário quer legendas/legendas ocultas em um vídeo de cabeça falante
  • O usuário quer uma barra de legenda literal (terço inferior padrão)
  • O usuário quer texto cinematográfico incorporado atrás do sujeito (o batimento do clímax)
  • O usuário quer adicionar acessibilidade a um vídeo
  • O usuário quer queimar legendas para mídias sociais (sem faixa de legenda)

Quando NÃO Usar

  • O usuário quer um fluxo de trabalho de vídeo completo (use hyperframes-product-launch-video)
  • O usuário quer um explicador completo (use hyperframes-faceless-explainer)
  • O usuário quer legendas como um arquivo lateral (SRT/VTT) — esta skill as queima

O Modelo de Legenda — Drop / Rail / Embed

O quêComo é mostrado
droppreenchimento — hum/ah, gaguejosnão mostrado
railo padrão — conteúdo falado comumlegenda limpa no terço inferior, na frente
embedum pico promovido — o batimento principaluma palavra grande atrás do sujeito (oclusão fosca)

A barra (rail) carrega a maior parte do texto; embed é o pico escasso e conquistado — ≤1 por batimento, nunca dois adjacentes, espaçados ≥ um batimento de distância.

A Lei de Sobreposição

Uma linha de legenda é composta SOBRE o filme como uma sobreposição; NÃO é uma zona reservada.

  • Centralize a composição no centro vertical VERDADEIRO (y = H/2). Não desloque o conteúdo para cima para "abrir espaço" para legendas.
  • O conteúdo pode se estender até a parte inferior da tela.
  • Evite colocar texto pequeno e crítico (URL, linha legal) no span central de ~80px na parte inferior onde a linha de legenda fica.
  • Nenhuma barreira de exclusão de máquina — julgue a legibilidade visualmente.

Fluxo de Trabalho

1 · Gerar voz over + timestamps de palavra

# Usando TTS com timestamps de palavra
node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>

2 · Alinhar legendas aos tokens de exibição

node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json

captions.json é a entrada da barra de legenda (ortografia de exibição, tempo falado).

3 · Construir a barra de legenda

const LINES = /* conteúdo de captions.json */ [
  { id: 0, end: 2.74, w: [["This", 0.0], ["week,", 0.30], ...] },
  ...
];

4 · Verificar presença de legenda

Amostre 3-4 quadros em toda a janela de fala da voz over e confirme que a barra de legenda renderiza texto visível em cada um. Se algum quadro em um intervalo de fala estiver sem legendas, a construção é enviada sem legendas — trate como uma barreira vermelha.

Tabela Anti-Racionalização

RacionalizaçãoRealidade
"Vou centralizar a 42% para deixar espaço para legendas"Centro verdadeiro (y = H/2) — legendas são sobreposição
"Vou incorporar cada palavra"Embed é escasso — barra carrega a maior parte do texto
"Vou pular timestamps de palavra"O áudio é o relógio — todos os tempos de batimento vêm de timestamps de palavra
"Vou usar ortografia fonética nas legendas"Legendas sempre renderizam a camada de exibição
"Vou adivinhar a pronúncia"Pergunte ao usuário, depois aumente o léxico

Verificação

  • Barra de legenda presente em 3+ quadros amostrados
  • Ortografia de exibição corresponde ao script (não fonética)
  • Timestamps de palavra alinhados com o áudio
  • Composição centralizada no centro verdadeiro (y = H/2)
  • Nenhum texto crítico na zona de sobreposição de legenda

Individual skills in this repo

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

oyi77/1ai-skills

Turn a weekly changelog .md into a finished branded changelog video using HyperFrames. Use when the user provides a changelog/digest markdown and wants the weekly video, or says 'changelog video'. Self-contained — fonts, background, lexicon, and scripts ship in the skill. Produces square 1080, ~45-60s videos with animated brand mock-UIs.

oyi77/1ai-skills

The transition technique catalog for HyperFrames videos — five velocity-matched SEAMS (zoom-through, inverse zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus in-scene techniques (waterfall entry, nudge curve). Covers partial-travel velocity matching, Z scale-sign rule, size-scaled blur, the 10/65/25 slide ratio, and the 2-3 transition budget. Read before authoring any transition, text-beat handoff, or kinetic text entry.

oyi77/1ai-skills

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video using HyperFrames. Use when the user wants a topic explainer, concept breakdown, how-to, or listicle with no product/website to capture. Every visual is invented per scene (typography, abstract graphics, diagrams, data-viz). Not a video built from a website (use hyperframes-product-launch-video).

oyi77/1ai-skills

The fallback HyperFrames workflow for anything that doesn't fit other skills — longer multi-scene pieces, brand/sizzle reels, title cards, static loops, freeform compositions. Input- and length-agnostic. Also the home of companion mode (co-create with the full toolbox). Use when no other HyperFrames skill matches, or when the user wants a freeform video.

oyi77/1ai-skills

Create short, unnarrated, design-led motion graphics (~under 10s) using HyperFrames. Use when the user wants kinetic type, stat/chart hits, logo stings, lower-thirds, animated tweets/headlines, or transparent overlay motion graphics. MP4 or transparent overlay output. Teaches seek-safe keyframe authoring and the 2-3 transition budget rule.

oyi77/1ai-skills

Turn a music track into a beat-synced HyperFrames video — lyric, slideshow, or kinetic promo. Use when the user provides an audio file, a video to pull audio from, or a mood brief for generated music. Music drives pacing. Teaches beat-map extraction, section-based scene planning, and audio-reactive visuals.

oyi77/1ai-skills

Create product launch videos from a URL, brief, or script using HyperFrames (HTML→MP4). Use when the user wants a product launch video, site tour, social clip featuring a product's own visuals, or marketing/promoting a product. Up to ~3 min (sweet spot 30-90s). Teaches the HyperFrames production loop: plan → write HTML → wire seekable animations → add media → lint → preview → render.

oyi77/1ai-skills

The Video Production Manager — manages ALL video production under 1ai-content. Delegates to HyperFrames, Remotion, AI video, and FFmpeg based on the task. Has memory via 1ai-hub brain, follows 1ai-rules, and reports to Content Director. Use when the user says 'make a video', 'create video', 'edit video', 'video strategy', or needs any video production work.

oyi77/1ai-skills

Agent skill at content/video/gen/SKILL.md

oyi77/1ai-skills

Use when track portfolio company KPIs, variances, returns analysis. Use when user says "monitor portfolio", "track KPIs", "portfolio returns".

oyi77/1ai-skills

Use when go-to-market planning — launch sequencing, channel strategy, audience building, PR outreach. Use when planning product launches, building launch checklists, or coordinating multi-channel campaigns.

oyi77/1ai-skills

Use when portfolio manager — capital allocation, risk management, and performance metrics tracking for trading strategies.

Habilidades Relacionadas