Communitygithub.com

Hownameee/vídeos-curtos

Executa a Fase 2 do fluxo de vídeos curtos: converte uma direção explicitamente selecionada e sua pesquisa em um roteiro revisável, incluindo beat sheet, narração, timing flexível de cenas, texto na tela, plano visual, legendas, dicas de música e SFX, notas de pronúncia, conclusão e CTA contextual. Use quando um usuário pedir para escrever, revisar, pré-visualizar ou aprovar um roteiro de vídeo curto. Pare para aprovação do roteiro e não gere TTS ou renderize vídeo ainda.

O que é vídeos-curtos?

Este skill é responsável pela Fase 2 de um fluxo de trabalho de vídeos curtos, transformando uma direção e pesquisa pré-selecionadas em um roteiro completo e revisável. Ele estrutura o conteúdo em duas passagens: primeiro criando um beat sheet com seções como gancho de tensão, promessa, explicação e conclusão, e depois desenvolvendo um plano detalhado de cena com narração exata, texto na tela, ações visuais, dicas de áudio e notas de pronúncia. O skill garante que as afirmações factuais estejam vinculadas a IDs de fontes e que o tempo seja gerenciado como um orçamento, evitando cenas muito densas. Ele também aplica padrões de produção como resolução 2160x3840 e 60 fps, além de gerar um plano de som compacto. Após a escrita, o roteiro é apresentado em um formato legível e o usuário deve aprovar ou solicitar revisões antes de prosseguir para a produção, usando comandos como 'video script --draft' e 'video script --approve'. O skill suporta plataformas como Claude Code e similares, parando na aprovação sem gerar TTS ou renderizar vídeo.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hownameee/short-videos/tree/HEAD/.agent/skills/short-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 Curto

Possui a Fase 2. Leia a direção selecionada e sua pesquisa antes de escrever. Use os contratos de artefato ao persistir a saída.

Pré-condições

Confirme que a direção está explicitamente selecionada. Se estiver faltando, redirecione de volta para short-video-discovery. Não escolha uma direção silenciosamente, a menos que o usuário tenha solicitado seleção automática; ao selecionar automaticamente, use a direção recomendada e registre essa suposição.

Exija que a direção selecionada faça referência à versão atual da pesquisa. Se a pesquisa estiver ausente ou desatualizada, pare e corrija a Fase 1 em vez de preencher lacunas de memória.

Rejeite ou suavize qualquer gancho que seja mais forte do que a pesquisa. Mantenha IDs de fontes vinculados a afirmações factuais ao longo do plano de cena.

Escreva em duas passagens

Beat sheet

Defina o trabalho de cada batida antes de escrever a narração polida:

  1. gancho de tensão;
  2. promessa, que pode se sobrepor ao gancho;
  3. configuração do caso de uso, quando necessário;
  4. uma a três batidas explicativas ou demonstrativas;
  5. conclusão com prova ou resultado;
  6. lição em uma frase;
  7. um CTA contextual, que pode se sobrepor à conclusão.

Trate o tempo como um orçamento:

SeçãoDuração típica
Gancho de tensão3–7s
Promessa2–5s
Configuração do caso de uso4–10s
Explicação/demo20–40s
Conclusão/evidência5–15s
Lição2–6s
CTA contextual2–6s

Os orçamentos podem se sobrepor e não precisam preencher a duração alvo. Termine cedo quando a conclusão estiver completa.

Roteiro e plano de cena

Escreva para ser ouvido: orações curtas, uma ideia por frase, verbos concretos e pausas naturais. Evite saudação, introdução standalone com logotipo, listas densas, experiência pessoal falsa e estatísticas sem suporte.

Para cada cena, forneça:

  • propósito e duração flexível;
  • narração exata;
  • texto na tela;
  • tipo visual, ação e necessidades de ativos;
  • intenção de agrupamento de legendas;
  • dica de música e SFX;
  • transição;
  • IDs de fontes;
  • notas de pronúncia Kokoro para siglas, nomes de produtos, números e URLs.

Aplique os padrões de produção do repositório: novos vídeos usam meta.width: 2160, meta.height: 3840, meta.fps: 60 a menos que explicitamente sobrescrito. Siga o formato gravado da solicitação; não copie metadados de projeto antigo 1080p/30 fps para um novo roteiro padrão. O comando draft preenche campos de formato ausentes antes da aprovação. Planeje o movimento em segundos para que sua velocidade seja independente de fps. Mantenha os padrões de saída em inglês, captions.mode: "word-highlight" e um plano de movimento concreto por cena. Registre o que muda visualmente, sua dica de narração e o estado final; "aparecer o slide" sozinho não é um plano de movimento de cena. Projete grupos de legendas para uma ou duas linhas; os tempos reais das palavras vêm da geração de voz, não do roteiro.

Inclua o plano de som compacto dos padrões nas notas de produção: emoção pretendida, música durante gancho/explicação/revelação/fim, ducking e dicas seletivas de acento vinculadas à narração ou visuais. "Música ambiente" ou uma lista SFX vazia sozinha não é um plano de som. Leve-o para a produção sem exigir outro lembrete; respeite e registre uma substituição explícita de som pelo usuário.

Quando o usuário solicitar uma direção de arte detalhada ou o plano de cena definir layout concreto, tipografia, cor, diagrama, legenda, movimento ou comportamento de transição, leia ../short-video-visual-design/SKILL.md. Mantenha o planejamento visual em nível editorial na Fase 2; JSX detalhado permanece trabalho da Fase 3.

Trate as grafias de pronúncia como candidatas a serem testadas, não instruções de renderização autoritativas. Isso é importante quando o idioma do roteiro não possui uma voz disponível no provedor TTS selecionado.

Estime a duração da fala e sinalize cenas que estão muito densas. Não resolva uma cena muito longa aumentando cegamente a velocidade do TTS; encurte o texto ou expanda a cena primeiro.

Formato de revisão

Apresente um script.md legível e conciso nesta ordem:

  1. título, público, faixa de duração, tom;
  2. gancho, promessa, conclusão, lição, CTA;
  3. uma tabela de cenas contendo a função da batida, narração e notas de produção;
  4. apenas as fontes, candidatos de pronúncia, suposições e avisos que não estejam claros na tabela;
  5. duração total estimada.

Peça uma decisão: aprovar o roteiro ou listar revisões. Não chame Kokoro, busque ativos de produção, inicie o Remotion Studio ou renderize enquanto a aprovação estiver pendente.

Registre edições com video script --draft (também suportado após a produção). Após aprovação explícita, use video script --approve; não defina manualmente hashes ou timestamps de aprovação. Registre script_approved. Redirecione para short-video-production somente quando o usuário também solicitar uma pré-visualização ou renderização final; a aprovação por si só aguarda no portão.

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

>- Design and review a coherent visual system for short-form video before and during Remotion implementation. Use for video art direction, scene UI, typography, layout, color, diagrams, captions, motion, transitions, platform safe areas, or visual-quality review. Use Remotion skills separately for API, timeline, media, Studio, and rendering behavior; do not use this skill for narration-only or research-only work.

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