Communitygithub.com

cgallic/kai-cmo-harness

Produza roteiros de vídeo e planos de clipes para TikTok, YouTube Shorts, Instagram Reels e YouTube de formato longo. Gera roteiros otimizados para cada algoritmo da plataforma, além de um plano de clipes para extrair formato curto de conteúdo longo. Use quando solicitar "roteiro de vídeo", "roteiro TikTok", "roteiro YouTube", "roteiro Reels", "roteiro Shorts", "conteúdo de vídeo", "plano de clipes", "ideias de vídeo" ou qualquer pedido para criar conteúdo de vídeo para plataformas sociais.

O que é kai-cmo-harness?

Esta skill (cujo nome original é /kai-video) automatiza a geração de roteiros prontos para gravação e planos de clipes defensáveis para conteúdo de vídeo em plataformas sociais como TikTok, YouTube Shorts, Instagram Reels e YouTube de formato longo. É especialmente útil para profissionais de marketing, criadores de conteúdo e equipes de crescimento que precisam produzir múltiplos roteiros otimizados para algoritmos específicos, sem depender de perguntas de follow-up. A skill funciona analisando o arquivo MARKETING.md do projeto (ou construindo um a partir do repositório) e carregando guias específicas de cada plataforma (como algoritmos do TikTok, YouTube e Instagram) antes de gerar qualquer conteúdo. Ela produz roteiros hook-first — onde os primeiros três segundos decidem o sucesso — e planos de clipes que mapeiam momentos exatos de fontes longas para formato curto, com scores de qualidade (clip scoring) e restrições como zero palavras banidas e zero slop de IA. A saída é organizada em pastas workspace/video/ com planos, roteiros individuais por plataforma e relatórios de qualidade. A skill suporta plataformas como Claude Code (via SKILL.md), mas seu design é genérico e pode ser adaptado para qualquer agente ou ambiente de desenvolvimento que siga a estrutura de skills do Kai. O fluxo inclui verificações de qualidade (E5/C2/O3), requisitos de aprovação humana para publicação e escalonamento quando direitos de fonte ou permissões de convidados não estão confirmados.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cgallic/kai-cmo-harness/tree/HEAD/harness/skills-v2/kai-video

Perguntar na sua IA favorita

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

Documentação

/kai-video — roteiros prontos para gravação e uma lista de clipes defensável

Nota raiz Kai: os caminhos knowledge/, harness/ e scripts/ nesta skill residem na instalação do Kai, não no projeto do usuário. Resolva-os em relação ao primeiro diretório ancestral deste SKILL.md que contenha uma pasta knowledge/ (a raiz do plugin Kai, ~/.claude/kai ou o repositório kai-cmo-harness). MARKETING.md, memory/ e quaisquer arquivos de saída residem no projeto atual. Se um comando scripts/ referenciado não estiver disponível nesta instalação, informe isso, pule-o e continue com as orientações baseadas em arquivos — nunca invente sua saída.

Objetivo

Roteiros que alguém pode gravar sem precisar fazer uma pergunta de acompanhamento e — quando existir fonte de formato longo — um plano de clipes nomeando quais momentos se tornam formato curto, em quais timestamps e por quê. Foco em hook e específico por plataforma: os primeiros três segundos decidem se o resto do trabalho importa.

Pronto quando

Tipo de trabalho social-post — piso E5/C2/O3 (harness/eco-floors.yaml), contrato harness/skill-contracts/social-post.yaml.

  • E5 — o vídeo está no ar e um não-ator leu o permalink público de volta contra o roteiro e corte aprovados. Um arquivo de roteiro em workspace/ é E1; aprovação do roteiro exato é E3. Esta skill atinge o artefato; a publicação é uma etapa separada e aprovada.
  • C2 — four_us_score em 10/16 e banned_word_check limpo no texto do roteiro, mais a barra por roteiro abaixo.
  • O3 — alcance, taxa de engajamento, cliques no perfil e cliques em links lidos a partir dos insights da plataforma em 7 dias, contra uma linha de base registrada antes da publicação.

Barra por roteiro: hook nos primeiros 3 segundos (sem introduções, sem "oi pessoal", sem animação de logotipo) · uma ideia por vídeo de formato curto · zero palavras banidas e zero slop de IA · um CTA que fecha naturalmente, não sendo enfiado à força · direção visual incluída, não apenas palavras · duração apropriada para a plataforma.

Restrições

  • Leia MARKETING.md da raiz do projeto antes de perguntar qualquer coisa ao usuário. Se não existir, construa-o a partir do codebase — CLAUDE.md, README.md, PROJECT.md, package.json, landing pages, configuração de e-mail/anúncios/analytics — usando o template de /kai-email-system e confirme o rascunho.
  • Saiba estes antes de roteirizar: tópico, plataformas-alvo, formato (cabeça falante, gravação de tela, b-roll, animação), faixa de duração (15–60s formato curto ou 5–15min formato longo), objetivo e qualquer conteúdo existente para adaptar.
  • Carregue o guia da plataforma antes de escrever para essa plataforma — os algoritmos diferem e as regras de ritmo não são transferíveis.
  • Cada linha de clipe carrega um timestamp de origem ou localizador de arquivo. Se a fonte for um convidado, cliente, podcast ou programa de terceiros, marque o status de aprovação antes da exportação e siga harness/references/transcript-video-research-rules.md.
  • Planos de clipes são ensaios. Publicação ou upload requer aprovação humana.
  • Varie a fórmula do hook entre os vídeos. Repetir uma fórmula em uma sequência treina o público a pular.

Contexto

NecessidadeCarregar
Mecânicas de conteúdo de vídeoknowledge/playbooks/video-content-creation.md
TikTokknowledge/channels/tiktok-algorithm.md
YouTube (Shorts e formato longo)knowledge/channels/youtube.md
Instagram Reelsknowledge/channels/instagram.md
Recorte de formato longo em curtoknowledge/playbooks/video-clipping-automation-workflow.md
Qualquer transcrição, legenda, podcast, webinar ou fonte de terceirosharness/references/transcript-video-research-rules.md
Produto, ICP, voz, canaisMARKETING.md (raiz do projeto)

Roteiro de formato curto (15–60s) contém: plataforma, duração, formato, HOOK (0–3s, interrupção de padrão — pergunta, afirmação ousada ou surpresa visual), CORPO (3–45s, uma ideia e um aprendizado com direção visual entre colchetes), CTA (últimos 3–5s), sobreposições de texto na tela com timestamp, 3–5 hashtags apropriadas para a plataforma e uma sugestão de áudio em tendência ou "áudio original".

Roteiro de formato longo (5–15min) contém: HOOK (0–30s visualizando o payoff), INTRODUÇÃO (30s–1min: contexto, credibilidade, promessa de estrutura), três seções de conteúdo com direção visual, RECAP + CTA, timestamps de capítulo e um conceito de miniatura (3–5 palavras de texto do título, expressão, visual chave).

Fórmulas de hook — rotacione em uma sequência:

TipoFórmulaExemplo
Pergunta"Você sabia que [fato surpreendente]?""Você sabia que 73% dos leads ligam fora do horário comercial?"
Afirmação ousada"[Declaração contrária]""E-mail frio está morto. Aqui está o que o substituiu."
Problema"Se você está lutando com [X]...""Se sua landing page converte abaixo de 3%..."
Resultado"Fomos de [ruim] para [bom] em [tempo]""Fomos de 2% para 11% de conversão em 3 semanas"
Lista"[Número] [coisas] que [resultado]""5 e-mails que todo SaaS precisa no primeiro dia"

Pontuação de clipes — pontue cada candidato antes de roteirizá-lo, 1–5 por fator:

FatorPergunta
HookOs primeiros 3 segundos criam um motivo claro para continuar assistindo?
Clareza autônomaO espectador pode entender o momento sem a fonte completa?
ProvaInclui um exemplo concreto, resultado, citação ou momento de demonstração?
TensãoContém contraste, surpresa, objeção, riscos ou uma revelação?
Segurança da fonteA afirmação é atribuível e liberada para uso?

Clipes com pontuação 18/25 ou superior são candidatos à produção. Pontuações mais baixas vão para workspace/video/clipping-plan/_kill-list.md com o motivo.

Saída vai para workspace/video/: _video-plan.md, short-form/ (roteiros por plataforma), long-form/, clipping-plan/clips-from-[source].md, _quality-report.md.

Escalonar quando

  • Os direitos do material de origem, aprovação do convidado ou permissão do cliente para um clipe não estão confirmados.
  • Uma afirmação no roteiro precisa de um número que não tem fonte.
  • A duração ou formato solicitado entra em conflito com as normas atuais da plataforma no guia de canal carregado.
  • O usuário deseja que o vídeo seja renderizado em vez de roteirizado — isso é /kai-video-production.
  • Qualquer coisa seria enviada ou publicada antes da aprovação humana.

Individual skills in this repo

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

Habilidades Relacionadas