Communitygithub.com

Akira-TL/akira-video-skills

Converte romances, capítulos, resumos de histórias, briefings de marca ou outros conteúdos upstream no próprio roteiro de um vídeo; use ao escrever ou revisar SCRIPT.md, definições de atuação de personagens, definições de cenas, diálogos ou quadro geral de planos.

O que é akira-video-skills?

Este Skill é especializado em transformar materiais upstream (como romances, capítulos, resumos de histórias ou briefings de marca) em um roteiro de vídeo autocontido e acionável, seguindo rigorosamente a separação de responsabilidades para evitar duplicação de fontes. Ele suporta plataformas como Claude Code e Cursor, fornecendo diretrizes claras para criar ou revisar arquivos essenciais como SCRIPT.md, CHARACTERS.md, SCENES.md e SHOTS.md. O Skill enfatiza a preservação da causalidade narrativa, performances observáveis e diálogos naturais, garantindo que o roteiro sirva como uma camada prática para produção de vídeo, sem substituir as fontes originais. Ele também gerencia restrições de duração, continuidade de personagens e uso criterioso de narração, tornando-o ideal para desenvolvedores e agentes de IA que produzem conteúdo de vídeo a partir de fontes textuais complexas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Akira-TL/akira-video-skills/tree/HEAD/skills/video/video-script

Perguntar na sua IA favorita

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

Documentação

Roteiro de Vídeo

Este Skill possui apenas as definições de produção de vídeo em video/script/. Romances, mundos, capítulos, arquivos completos de personagens, materiais de clientes ou outras fontes upstream continuam pertencendo às suas fontes originais; aqui são salvas apenas as transformações e escolhas feitas para a atuação, cena e produção de planos do vídeo atual.

1. Ler Fonte Upstream e VIDEO.md

Primeiro, leia VIDEO.md e a fonte upstream especificada pelo usuário. Quando a fonte for um romance, capítulo ou outra narrativa longa, leia primeiro references/ADAPTATION.md. Extraia apenas os fatos, relações entre personagens, enredos, cenas, produtos ou restrições realmente necessários para o vídeo atual; mantenha ponteiros, não copie o conteúdo completo da fonte upstream para a camada de roteiro.

Se houver conflitos entre as fontes ou fatos essenciais ausentes, primeiro identifique as lacunas; não invente fatos upstream para completar o roteiro.

2. Estabelecer Camada Mínima de Roteiro

As responsabilidades dos quatro arquivos de roteiro comuns são mantidas separadas conforme references/SCRIPT-FILES.md; evite copiar design visual, fotografia e parâmetros de geração de volta para a camada de roteiro. Ao escrever os arquivos propriamente ditos, use os modelos mínimos em references/SCRIPT-TEMPLATES.md e crie apenas os arquivos necessários para o projeto atual.

Crie apenas os arquivos que o projeto atual precisa:

  • SCRIPT.md: história, estrutura, cenas, ações e diálogos do vídeo atual;
  • CHARACTERS.md: requisitos de atuação, aparência, diálogo e voz dos personagens no vídeo atual;
  • SCENES.md: cenários, espaços, representação do mundo e ênfases de continuidade usados no vídeo atual;
  • SHOTS.md: visão geral de todos os planos do vídeo.

Projetos com planos de produto simples, vídeos sem personagens ou roteiros já completos podem omitir qualquer um desses arquivos. Não crie arquivos vazios apenas para completar o modelo.

3. Narrativa e Personagens

Quando o vídeo atual contiver narrativa completa, arcos de personagens, diálogos ou elementos cômicos, leia primeiro references/NARRATIVE.md. Quando mudanças emocionais dos personagens, reações importantes ou conflitos de relacionamento precisarem realmente ser traduzidos em atuação de plano, leia references/PERFORMANCE.md e converta palavras emocionais em movimentos corporais observáveis, direção do olhar, ações e batidas de comportamento. Abaixo, mantenha apenas as regras mínimas necessárias para todos os projetos narrativos.

Em narrativas, priorize garantir que a cadeia causal e as ações dos personagens façam sentido, antes de buscar espetáculos visuais:

  • Eventos são impulsionados por condições pré-existentes, escolhas dos personagens ou eventos anteriores;
  • Personagens agem e falam apenas com base nas informações conhecidas no momento;
  • Reviravoltas importantes vêm de escolhas dos personagens ou de regras já estabelecidas;
  • Ações, informações ou elementos visuais que precisam ser recuperados no final devem ser estabelecidos de forma genuína antes;
  • Produtos ou adereços não podem resolver problemas que não surgiram antes.

Definições de personagens não se limitam a rótulos de personalidade. Quando realmente necessário para o vídeo atual, registre objetivos, preocupações, modos típicos de ação, reações sob tensão, ritmo de diálogo, características vocais, faixa emocional permitida e mudanças ao longo do vídeo. Quando um personagem precisar manter identidade vocal entre planos, passe detalhes de timbre e referências de voz para video-audio, sem duplicar um segundo conjunto de especificações de voz na camada de roteiro.

4. Diálogos

Quando um plano contiver personagens visíveis falando, diálogos longos, conversas com múltiplos personagens ou sincronia labial, leia references/DIALOGUE-TIMING.md e primeiro confirme que as falas podem ser ditas naturalmente dentro da duração alvo antes de prosseguir para a geração de planos.

O diálogo serve ao comportamento atual do personagem, não é responsável por explicar o mundo para o autor. Narração / voz off também pertencem ao conteúdo do roteiro, mas só devem ser usadas quando realmente necessário para fornecer um ponto de vista narrativo, compressão temporal ou informações que a imagem não pode expressar naturalmente; a produção de áudio deve ser passada para video-audio conforme necessário, e a narração não deve ser usada como uma camada de explicação universal para corrigir enredos confusos. Priorize que a fala anterior, a ação anterior ou novas informações levem naturalmente à próxima fala; informações que podem ser expressas por ação não devem ser repetidas em diálogo.

Após concluir o diálogo, revise rapidamente toda a conversa em ordem cronológica contínua, verificando problemas como mudanças abruptas de assunto, repetições de explicação, transições emocionais ausentes e todos os personagens usando o mesmo padrão de frase. Diálogo natural não significa inserir gírias da internet à força.

Quando VIDEO.md tiver uma duração total definida / limite estrito, leia references/DURATION-BUDGET.md e primeiro faça um orçamento aproximado de duração com base nos parágrafos da história e SHOTS.md, para evitar descobrir que a duração total está fora de controle somente após a geração.

5. Cenas e Visão Geral dos Planos

SCENES.md registra apenas os espaços, regras visuais e de mundo necessários para o vídeo atual. Mecanismos complexos, dispositivos incomuns ou relações espaciais críticas podem ter explicações detalhadas colocadas em arquivos de descrição ao lado dos ativos reutilizáveis correspondentes, sem empilhar todas as regras de baixa frequência em SCENES.md.

SHOTS.md é usado para ler rapidamente a disposição de todos os planos do vídeo do início ao fim. Cada entrada deve conter pelo menos o ID do plano, duração alvo, imagem/ação e propósito do plano; requisitos detalhados de produção devem ser passados para SHOT.md em video-shot.

Em projetos longos, adicione capítulos ou níveis superiores de organização apenas quando a tabela de planos existente já estiver difícil de ler; não presuma hierarquia de nível cinematográfico.

Critérios de Conclusão

A camada de roteiro deve ser suficiente para que o próximo passo saiba claramente: sobre o que é este vídeo, como os personagens atuam, como as cenas são apresentadas e quais planos são necessários; ao mesmo tempo, não deve duplicar a fonte upstream como um segundo banco de fatos.

Individual skills in this repo

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

Akira-TL/akira-video-skills

为 Runway 当前视频模型编译和检查生成提示词;当 video-generation 需要使用 Runway(当前主线 Gen-4.5)的 Text to Video 或 Image to Video,并需要 Runway 专用动作、摄影和时序表达时使用。

Akira-TL/akira-video-skills

为 ByteDance / BytePlus Seedance 当前视频模型编译和检查提示词;当 video-generation 需要使用 Seedance 2.5 的参考素材、时间线、同步声音、视频编辑、延长或多镜头能力时使用。

Akira-TL/akira-video-skills

为 Google Veo 视频生成编译和检查提示词;当 video-generation 需要使用 Veo 的 Text to Video、Image to Video、首尾帧、参考元素或同步声音能力时使用,并先核验具体 Google 使用入口与 model 的当前支持范围。

Akira-TL/akira-video-skills

进入并持续推进一个 AI 视频制作项目;读取或建立 VIDEO.md,根据当前视频脚本、复用素材、镜头、生成结果和整片后期状态,按需路由到 canonical 视频专业 Skill,而不是把所有制作规则塞进一个总提示词。

Akira-TL/akira-video-skills

为品牌短片、产品植入剧情、广告或比赛作品建立产品事实与广告边界;当视频需要准确表达某个具体产品的官方功能、参数、结构、使用方式、品牌素材或产品与剧情关系时使用。

Akira-TL/akira-video-skills

设计并维护 AI 视频中跨镜头复用的角色声音、音色参考、对白声音要求与整片声音关系;当同一角色需要跨镜头保持声音一致,或需要规划语音参考、环境声、音效、音乐与画面的职责边界时使用。

Akira-TL/akira-video-skills

设计 AI 视频中的角色与场景视觉方案;当脚本只说明“需要一个什么样的人/场景”,但还没有形成可稳定生成的外形、服装、材质、色彩、空间、光线和视觉识别系统时使用。

Akira-TL/akira-video-skills

组织整片级剪辑、合成、全片声音和最终成片;当多个已采用镜头需要进入 Premiere Pro、After Effects、DaVinci Resolve 等后期工程,或需要整片字幕、Logo、音乐、混音、比例版本和最终导出时使用。

Akira-TL/akira-video-skills

为 AI 图片或视频生成准备可直接使用的提示词与一次性生成包,并在用户把生成结果带回项目后归档;当需要从正式视频脚本、复用素材和 SHOT.md 编译生成内容、选择参考素材、约定返回文件名或清理临时包时使用。

Akira-TL/akira-video-skills

规划、创建、整理和维护多个镜头会重复使用的视频复用素材;当需要人物/场景/道具/产品提示词、参考图、官方素材、身份与状态参考或其他可重复引用内容时使用。

Akira-TL/akira-video-skills

审核 AI 生成的人物/场景等复用素材或镜头生成结果,判断采用、修改提示词、重生成还是留给后期修复;当生成结果返回项目、需要检查身份/结构/连续性/动作/摄影/产品真实性或选择生成结果时使用。

Akira-TL/akira-video-skills

把 SHOTS.md 中的镜头总览展开成可直接制作的单镜头定义;当需要创建或修改 video/shots/<shot-id>/SHOT.md、镜头连续性、摄影、动作、表演、声音或镜头专属生产约束时使用。

Habilidades Relacionadas