Communitygithub.com

Hownameee/short-videos

Projete e revise um sistema visual coerente para vídeos curtos antes e durante a implementação com Remotion. Use para direção de arte de vídeo, UI de cena, tipografia, layout, cor, diagramas, legendas, movimento, transições, áreas seguras de plataforma ou revisão de qualidade visual. Use as habilidades Remotion separadamente para API, linha do tempo, mídia, Studio e comportamento de renderização; não use esta habilidade para trabalhos apenas de narração ou apenas de pesquisa.

O que é short-videos?

Hownameee/short-videos é uma habilidade especializada para direção de arte visual e garantia de qualidade em vídeos curtos (Shorts, Reels, TikTok), projetada para complementar habilidades técnicas do Remotion. Ela define todo o sistema visual antes de qualquer implementação em JSX, incluindo tese visual, paleta de cores, sistema tipográfico, gramática de movimento e linguagem de ativos. A habilidade enfatiza composição otimizada para telas de celular, hierarquia visual clara, uso intencional de espaço negativo e movimento que serve a propósitos específicos (orientar, revelar, enfatizar ou conectar). Ela rejeita ativamente padrões genéricos de template gerado, como cards arredondados centrados, gradientes sem propósito e efeitos constantes de bounce ou zoom. O fluxo de trabalho inclui a definição de um bloco `design` compacto no `video.json`, a revisão de composição em escala de telefone e a verificação rigorosa de quadros renderizados antes da aprovação final, com geração de um contact sheet como evidência visual. Esta habilidade não substitui habilidades Remotion para APIs, código, timeline ou renderização; é uma camada de direção de arte e revisão de qualidade visual que atua em conjunto com elas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hownameee/short-videos/tree/HEAD/.agent/skills/short-video-visual-design

Perguntar na sua IA favorita

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

Documentação

Design Visual de Vídeos Curtos

Assuma a responsabilidade pela linguagem visual e pelo padrão de qualidade. Leia o script.md aprovado, o video.json, a plataforma de destino, o público e os ativos disponíveis antes de escrever ou revisar a UI de cena. Preserve regras explícitas de marca e referências do usuário.

Esta habilidade decide composição, hierarquia, direção de arte e intenção de movimento. As habilidades Remotion importadas permanecem autoritativas para estrutura JSX, APIs, temporização, manipulação de mídia, Studio e renderização.

Defina o sistema visual antes do JSX

Escreva um bloco design compacto no video.json, ou registre as mesmas decisões nas notas de produção do projeto quando o esquema ainda não estiver implementado:

  • Tese visual: uma frase conectando a aparência à promessa do vídeo.
  • Clima: dois ou três adjetivos compatíveis; evite um conjunto de tendências não relacionadas.
  • Papéis da paleta: fundo, superfície, texto principal, texto secundário, destaque e cores semânticas de sucesso/aviso/erro quando a história precisar delas.
  • Papéis tipográficos: título, texto de apoio, legenda, e monoespaçado/dados quando apropriado. Prefira uma família com uma pequena faixa de pesos; adicione uma segunda família apenas quando ela criar um contraste editorial claro.
  • Sistema espacial: limites de conteúdo, grade de alinhamento, ritmo de espaçamento, linguagem de cantos e traços, e uma área segura específica da plataforma.
  • Gramática de movimento: comportamento de entrada, ênfase, transição e saída. Reutilize um pequeno conjunto de ideias de movimento em vez de inventar um novo efeito em cada cena.
  • Linguagem de ativos: regras para fotografia, ilustração, ícone, captura de tela, código, diagrama, textura e tratamento de cor.

Não comece uma UI detalhada a partir de palavras vagas como "moderno" ou "bonito". Converta-as em escolhas visíveis. Se o script não tiver uma tese visual clara, escolha o menor sistema que se encaixe no público e no assunto e registre a suposição.

Componha para uma tela de celular

  • Dê a cada momento um ponto focal dominante e uma ordem de leitura pretendida.
  • Faça o primeiro quadro comunicar tópico ou tensão sem esperar pela narração.
  • Use texto na tela como ênfase editorial, rótulos ou evidência. Não cole a narração completa no canvas fora da camada de legenda.
  • Mantenha texto, prova e ação principal dentro de um retângulo seguro da plataforma declarado nos dados do projeto. Visualize sobreposições para a plataforma de destino real; não presuma uma área segura universal do TikTok, Shorts e Reels.
  • Verifique a composição aproximadamente no tamanho de um telefone. Um layout que funciona apenas quando o canvas em resolução total preenche um monitor de desktop não é aprovado.
  • A entrega padrão é 2160×3840 a 60 fps. Um sistema de coordenadas de autoria de 1080×1920 é aceitável quando todo o layout, incluindo legendas, escala uniformemente. Use segundos para movimento, fps configurado para conversão de quadros e inspecione quadros nativos de saída, bem como prévias em tamanho de telefone.
  • Reserve espaço negativo ao redor do ponto focal. Espaço vazio faz parte da hierarquia, não uma área que deve ser preenchida com partículas, cartões, emblemas ou ícones.
  • Use profundidade intencionalmente: fundo estabelece contexto, plano médio carrega a explicação e primeiro plano contém a ênfase ou legenda atual.
  • Mantenha relações espaciais estáveis entre cenas relacionadas para que o espectador não precise reaprender o layout após cada corte.

Tipografia e densidade de informação

  • Estabeleça uma hierarquia clara de título, apoio e legenda. Níveis adjacentes devem diferir o suficiente em tamanho, peso, posição ou cor para serem reconhecidos rapidamente.
  • Quebre linhas por significado. Evite uma palavra curta isolada, divisão estranha de frase nominal ou largura de linha em constante mudança.
  • Mantenha a maioria dos quadros com uma afirmação, uma comparação ou uma ação. Revele diagramas complexos progressivamente em vez de apresentar todos os nós de uma vez.
  • Use rótulos próximos ao objeto que explicam. Evite legendas que forcem o espectador a olhar para frente e para trás em uma tela pequena.
  • Dê a código, números, gráficos e capturas de tela de interface tamanho suficiente para serem lidos. Corte para a evidência exata em vez de encolher uma tela de desktop inteira no quadro.
  • Legendas usam no máximo duas linhas em cenas normais, agrupam palavras por frase, mantêm alto contraste sobre fundos variáveis e destacam a palavra falada atual por padrão. Aplique ênfase editorial seletiva a títulos separadamente. Use tempos de palavra medidos, mantenha a pontuação anexada e evite alterar o layout da linha quando a palavra ativa mudar. Veja padrões de produção.

Cor, imagética e consistência

  • Escolha cores por papel, depois reutilize esses papéis. Não introduza um novo destaque porque uma cena posterior parece vazia.
  • Mantenha contraste legível para texto e bordas essenciais de diagramas. Adicione um fundo sólido ou translúcido quando a imagética tornar o contraste instável.
  • Use gradientes, brilho, vidro, ruído e sombras apenas quando eles suportarem a direção de arte escolhida. Empilhar todos eles não substitui a hierarquia.
  • Mantenha traço de ícone, perspectiva de ilustração, tratamento de fotografia e geometria de diagrama consistentes dentro de um vídeo.
  • Prefira visuais que carreguem evidência: a saída real, uma captura de tela focada, um antes/depois, um processo ou um diagrama que explique causalidade. Imagens de banco decorativas não devem substituir prova.
  • Verifique a resolução da imagem e o corte nas dimensões finais do retrato. Não estique, aumente ativos visivelmente quebrados nem oculte marcas d'água e marcas de licença.

Movimento e transições

Movimento é um requisito padrão para esses vídeos. Planeje uma ação visível e específica ao tópico para cada momento explicativo: um objeto se move, divide, desaparece, preenche, conecta ou muda de estado em sincronia com a narração. Emparelhe entradas com uma ação dentro da cena. Um fade de título, pulso decorativo minúsculo, deriva de câmera ou barra de progresso sobre um diagrama estático não cumpre este requisito. Use pausas intencionais para deixar um resultado ser registrado; não adicione movimento constante arbitrário.

  • Cada movimento responde a uma de quatro funções: orientar, revelar, enfatizar ou conectar. Remova movimento que não faça nenhuma delas.
  • Anime com um tempo e família de easing consistentes. Deixe o texto importante se acomodar tempo suficiente para ser lido antes de movê-lo novamente.
  • Preserve continuidade quando duas cenas compartilharem um objeto: mova, redimensione, recolorir ou renomeie esse objeto em vez de substituir o canvas inteiro sem motivação.
  • Use cortes para uma nova ideia, movimento combinado para um relacionamento e transições mais fortes apenas para uma mudança real de seção. Evite aplicar uma transição entre cada frase.
  • Alterne momentos densos/de alta energia com pausas mais simples. A recompensa e a conclusão geralmente precisam de menos movimento para que o resultado possa ser registrado.
  • Coordene a ênfase visual com a narração, música e efeitos sonoros. Não faça todas as camadas atingirem o pico ao mesmo tempo.

Evite a aparência de template gerado

Rejeite estes padrões, a menos que a direção de arte os justifique especificamente:

  • cada cena como um card arredondado centrado;
  • gradientes não relacionados e manchas brilhantes atrás de todo o conteúdo;
  • emblemas de pílula usados como decoração em vez de status ou categoria;
  • efeitos constantes de bounce, zoom, giro, partículas ou máquina de escrever;
  • uma fonte, família de ícones, raio ou transição diferentes em cada cena;
  • painéis e gráficos falsos que não comunicam informações reais;
  • capturas de tela minúsculas cercadas por grande interface decorativa;
  • legendas, título, rótulos e CTA competindo todos com o mesmo peso visual.

Originalidade vem de uma metáfora visual específica ao tópico, evidência, layout e relação de movimento. Ela não requer decoração máxima.

Revise antes da renderização final

Antes de aprovar o controle de qualidade visual, leia references/visual-review-checklist.md. Renderize ou capture o primeiro quadro, final do gancho, ponto médio de cada momento principal, recompensa e CTA como output/contact-sheet.png. Inspecione a prévia real em resolução total e em escala de telefone; uma compilação TypeScript ou captura de tela de componente isolado é insuficiente. Inspecione também a reprodução ou quadros consecutivos através de cada movimento importante e nos limites de palavras sucessivas. Retenha essa evidência de sequência com o relatório de controle de qualidade; a folha de contato sozinha não pode provar sincronia de animação ou karaokê.

Não aprove o controle de qualidade visual final enquanto qualquer problema crítico permanecer: texto ilegível, ponto focal pouco claro, colisão com UI da plataforma, ativo quebrado, visual enganoso, sobreposição de legenda/prova, mudança de estilo inexplicada, ou movimento que esconde informações.

Contrato de saída

Relate:

  1. a tese visual e o sistema escolhidos;
  2. as decisões visuais no nível da cena que apoiam materialmente a história;
  3. as verificações de folha de contato e escala de telefone realizadas;
  4. problemas visuais corrigidos e qualquer limitação residual.

Não afirme que um vídeo "parece profissional" sem inspecionar quadros renderizados ou uma prévia. Indique quando o resultado foi avaliado apenas a partir do código-fonte.

Exemplos de uso

Use esta habilidade para:

  • "Projetar as cenas Remotion para que este vídeo sobre Docker pareça premium."
  • "Revisar a hierarquia, legendas, transições e legibilidade em dispositivos móveis."
  • "Criar um estilo visual consistente para uma série de Shorts."

Não use como habilidade principal para:

  • escrever narração sem um plano visual;
  • corrigir um codec, renderização ou erro de API do Remotion;
  • projetar uma interface de aplicativo web não relacionada a vídeo.

Individual skills in this repo

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

Hownameee/short-videos

Generate, revise or troubleshoot local Kokoro narration, pronunciation and scene word timing. Reuse verified unchanged clips; inspect the Python environment before setup changes. Exclude research, visuals, music composition and publishing.

Hownameee/short-videos

Router for all Remotion skills

Hownameee/short-videos

Transcribing, displaying and animating captions

Hownameee/short-videos

Structure Remotion markup for interactivity

Hownameee/short-videos

Remotion Map animation knowledge

Hownameee/short-videos

Content, animation and effects best practices

Hownameee/short-videos

Upgrade Remotion, and related packages

Hownameee/short-videos

>- Run Phase 1 of the shared short-video workflow: turn a raw topic or prompt into a sourced research pack and 2–4 distinct video directions, each with a defensible tension hook, promise, payoff, beats, visual approach, duration range, and risks. Use whenever the user asks for video ideas, angles, research, facts, hooks, topic analysis, or choices before scriptwriting. Stop for the user's direction choice and do not silently continue into script or production.

Hownameee/short-videos

Produce an approved short video or correct an existing video's background sound, emotion, captions, mix or export. Generate only changed narration, render and review a current preview, run technical and editorial QC, then export. Exclude script-only and general audio-advice requests.

Hownameee/short-videos

>- Run Phase 2 of the shared short-video workflow: convert an explicitly selected direction and its research into a reviewable beat sheet, narration, flexible scene timing, on-screen text, visual plan, captions, music and SFX cues, pronunciation notes, payoff, takeaway, and contextual CTA. Use whenever a user asks to write, revise, preview, or approve a short-video script. Stop for script approval and do not generate TTS or render video yet.

Hownameee/short-videos

Coordinate prompt-to-short-video discovery, scripting and production. Resume existing projects and route soundtrack or mix corrections directly to production. Preserve direction choice and script approval; exclude general audio advice.

Habilidades Relacionadas