Communitygithub.com

oyi77/1ai-skills

Transforma um changelog semanal em um vídeo de changelog finalizado e com marca, usando HyperFrames. Utilize quando o usuário fornecer um changelog/resumo em markdown e quiser o vídeo semanal, ou disser 'vídeo de changelog'. Autossuficiente — fontes, fundo, léxico e scripts estão incluídos na skill. Produz vídeos quadrados 1080p, de aproximadamente 45-60 segundos, com UIs de marca animadas.

O que é 1ai-skills?

Esta skill automatiza a criação de vídeos de changelog polidos usando o HyperFrames, um sistema de renderização baseado em HTML. Ela foi projetada para desenvolvedores e gerentes de produto que desejam transformar notas de atualização de release em anúncios visuais envolventes, evitando listas de texto simples. A skill suporta as plataformas HyperFrames e Claude Code, e seu fluxo de trabalho envolve bootstrap a partir de assets da skill (fontes, música de fundo, padrão de fundo), análise do changelog markdown com corte editorial (orçamento de 45-60s, 4 temas), roteamento de cada tema para uma visualização animada de UI, escrita de um script de duas camadas (fala vs. exibição), geração de áudio com timestamps de palavras, e construção do projeto seguindo especificações de marca rigorosas. A saída é um vídeo MP4 quadrado 1080p. A skill impõe verificações rigorosas: o comando `hyperframes check` deve passar com 0 erros, `seam-gate.mjs verify` deve passar, e as legendas devem ser visíveis em quadros amostrados. A renderização só ocorre quando o usuário explicitamente solicita. Um ponto crucial é o princípio fundamental de 'Visualizar, não Listar': cada tema deve ser ilustrado por uma animação de UI mock que representa a mudança, e não por marcadores de texto.

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

Perguntar na sua IA favorita

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

Documentação

Visão Geral

Esta skill transforma um changelog de release em uma composição de vídeo polida usando a renderização baseada em HTML do HyperFrames. Use-a quando uma atualização de produto merece um anúncio visual — quadros heróis, chamadas principais de marcadores e um padrão de fundo. Ela produz um MP4 renderizado a partir das entradas do changelog que você fornecer.

HyperFrames — Vídeo de Changelog

Entrada: um changelog .md (temas + itens). Saída: um projeto HyperFrames limpo, com verificação de costura (seam-gate) aprovada. Renderize apenas quando solicitado.

Quando Usar

  • O usuário fornece um changelog/resumo markdown e deseja o vídeo semanal
  • O usuário diz "vídeo de changelog" ou "vídeo do resumo semanal"
  • O usuário deseja um vídeo com marca com UIs mock animadas e narração

Quando NÃO Usar

  • O usuário deseja um lançamento de produto (use hyperframes-product-launch-video)
  • O usuário deseja um gráfico em movimento (use hyperframes-motion-graphics)
  • O usuário deseja um vídeo com apresentador (use hyperframes-embedded-captions)

A Diretriz Principal: Visualize, Não Liste

Cada tema é ilustrado por um mock animado da UI real ou de um análogo fiel representando a mudança na experiência — nunca marcadores de texto. Roteie cada tema/item pelo registro de visualização ANTES de escrever o script.

Fluxo de Trabalho

0 · Inicialização a partir dos assets da skill (innegociável)

mkdir -p project/assets/fonts
cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/
cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3
ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
  -vf "scale=1080:1080,fps=30,eq=saturation=0.72,[email protected]:t=fill" \
  -an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4
cp <SKILL_DIR>/examples/master-skeleton.html project/index.html

Em seguida, leia references/build-spec.md de ponta a ponta — ele define os tokens da marca.

1 · Análise e corte editorial

  • Extrair: intervalo de semanas, estatísticas principais, temas, itens
  • Orçamento: 45-60s no total. Título ≤2s, encerramento ≤3.5s, 4 temas ≈ 9-12s cada
  • Por tema, mantenha UMA visualização principal + no máximo 3 itens falados
  • Ordene os temas por história: funcionalidade principal → superfície do produto → desempenho → confiabilidade

2 · Roteamento de visualização

Para cada tema, escolha a superfície do registro de visualização e escreva uma linha: tema → superfície → as 2-4 ações sequenciais que o mock executa, cada uma ligada a uma frase do script.

3 · Script de duas camadas (falado vs. exibido)

Escreva o script como linhas de tokens: registro conversacional, cada termo técnico carregando uma forma spoken fonética enquanto display mantém a ortografia padrão. As legendas mostram display; a narração lê spoken.

4 · Narração + timestamps de palavras

node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json

Timestamps de palavras são uma verificação obrigatória. Antes de prosseguir, verifique se vo-words.json não está vazio e contém um array words: [...] com start/end por palavra.

5 · Construção

Siga references/build-spec.md exatamente: tokens da marca + fontes + a codificação do fundo animado + o esquema da cena + o chrome + a barra de legendas. Em seguida, a ordem da doutrina: ledger de vetores → carimbo de costura → batidas internas nas palavras da narração → verificação de costura.

Legendas são obrigatórias. Popule o array LINES a partir de captions.json antes de prosseguir.

6 · Verificações (todas verdes antes de apresentar)

  1. hyperframes check — 0 erros
  2. seam-gate.mjs verify — 0 falhas
  3. Reinicie o servidor de pré-visualização, verifique 3-4 batidas
  4. NÃO renderize a menos que o usuário solicite
  5. Verificação de presença de legendas — amostre 3-4 quadros, confirme que a barra de legendas está visível

Tabela Anti-Racionalização

RacionalizaçãoRealidade
"Slides com marcadores para mudanças de UI"Crie um mock da superfície representando a mudança
"UI falsa para itens não representáveis"Cena de checklist honesta
"'JSON' simples no texto TTS"Formas faladas no léxico; exibição permanece padrão
"Adivinhando pronúncia"Pergunte, então expanda o léxico
"Falando cada item do changelog"≤3 por tema; o link do resumo carrega o resto
"Acentos verdes em todo lugar"Um momento verde por cena
"Começando a partir do index.html de um vídeo anterior"Copie master-skeleton.html, sempre
"Array LINES vazio está tudo bem"LINES vazio = envio sem legendas = refazer a execução

Verificação

  • hyperframes check passa com 0 erros
  • seam-gate.mjs verify passa com 0 falhas
  • Barra de legendas visível em 3+ quadros amostrados
  • Timestamps de palavras alinhados com o áudio
  • Tokens da marca correspondem ao build-spec.md
  • Renderizado apenas quando o usuário explicitamente solicitar

Individual skills in this repo

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

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

Add captions/subtitles to talking-head or launch videos using HyperFrames. Use when the user wants embedded captions, verbatim caption rails, or cinematic text behind the subject. Covers the drop/rail/embed caption model, the overlay law (captions are NOT a reserved band), matte occlusion for embedded climaxes, and word-timestamp alignment from TTS output.

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