Communitygithub.com

dsonders/claude-skills

Produz um vídeo de treinamento ou tutorial narrado (com slides e PDF anotados) que mostra o aplicativo real TenthGear. Começa com um storyboard em um canvas de design (quadros-chave, anotações, faixa de voz) que Dave edita no local, depois captura imagens e filmagens do aplicativo ao vivo, narra com texto para fala da OpenAI e monta o vídeo.

O que é claude-skills?

Esta skill para o Claude é um pipeline completo de produção de vídeos de treinamento, transformando storyboards em vídeos narrados de alta qualidade baseados no aplicativo real TenthGear. Ela automaticamente roteiriza, captura imagens e filmagens do aplicativo, gera narração usando OpenAI (voz 'ash', modelo 'gpt-audio-1.5'), e monta o vídeo final. O processo é guiado por um arquivo único `storyboard.json` que Dave edita através de um canvas de design. A skill enfatiza que o storyboard deve ser aprovado antes da produção, que todo o conteúdo visual deve vir do aplicativo real (sem simulações), e que cada versão revisada deve ser preservada. Ela suporta a criação de vídeos de treinamento, guias de início rápido e slides PDF para técnicos e consultores da TenthGear. A verificação é baseada em transcrição de áudio e amostragem de quadros, e a skill declara explicitamente o que não foi verificado (como assistir ao vídeo inteiro) para manter a transparência.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/dsonders/claude-skills/tree/HEAD/video-training

Perguntar na sua IA favorita

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

Documentação

Treinamento em Vídeo: storyboard primeiro, depois o aplicativo real na tela

Um vídeo de treinamento aqui é um conjunto de cartões no formato de telefone. Cada cartão tem um título, uma linha de ajuda, um quadro-chave do aplicativo real com anotações e uma linha de narração. Alguns cartões reproduzem um pequeno clipe do aplicativo em vez de uma imagem estática. Os mesmos cartões são entregues como slides e um PDF.

Um arquivo controla tudo: storyboard.json. Dave o edita através de um canvas de design; todos os scripts de construção o leem.

Quando usar

Use para:

  • Um vídeo de treinamento, início rápido, guia rápido ou tutorial que mostra o aplicativo
  • Capturas de tela anotadas ou um guia de slides para técnicos, consultores ou pessoal de peças
  • Uma revisão de um vídeo feito com esta skill (novo texto, novo cartão, novo clipe)

Não use para:

  • Vídeo de marketing ou promocional (tom diferente, regras diferentes; pergunte ao Dave)
  • Vídeos de inspeção de cliente gravados dentro do produto
  • Uma maquete de uma tela que ainda não existe (use /visual)

Princípios

  1. Storyboard antes da produção. Nada é narrado ou montado até que Dave tenha editado o canvas do storyboard e dito que está pronto.
  2. Mostre o aplicativo real, fazendo a coisa real. Escaneamento real, ditado real, história gerada real. Nunca uma tela simulada, nunca resultados digitados.
  3. Dave decide no canvas, não no chat. Leia o canvas de volta e faça um diff. Não reconstrua sua direção a partir da conversa.
  4. Uma tomada aprovada é mantida. A narração é regerada apenas para linhas cujas palavras mudaram. Nunca sobrescreva uma versão que Dave revisou; envie -v2, -v3.
  5. Claude não pode ouvir nem assistir. Diga isso em cada devolução. Prove as palavras pela transcrição e as imagens por quadros de amostra, e nomeie o que não foi verificado.
  6. Deixe a loja como foi encontrada. Modo restaurado e confirmado, ordens de reparo de retomada fechadas.

Leia primeiro

  • /Users/davidsonders/ro-bot/shared/product-facts.md e shared/brand.md: nomes, contagens, palavras proibidas. Sem travessões, sem emojis, "TenthGear" como uma palavra. Nunca diga "single player" ou "multi-player" em nada que um espectador veja ou ouça.
  • reference.md nesta pasta: as armadilhas técnicas, cada uma já paga uma vez.
  • Notas de memória no canvas de design: reference_design_canvas_mechanics, reference_design_canvas_roundtrip, reference_design_canvas_entity_crash.

Onde as coisas ficam

O queOnde
Pasta do projeto de um vídeo/Users/davidsonders/ro-bot/training-videos/<slug>/ (nunca a área de rascunho da sessão, que morre com a sessão)
A única fonte da verdade<project>/storyboard.json
Quadros-chave, clipes, narração<project>/frames/, footage/, narration/
Compilações<project>/out/
O que Dave recebe~/Desktop/<Title>/
Exemplo práticotraining-videos/story-writer-getting-started/ e examples/story-writer/ aqui

Scripts estão em scripts/ aqui. Eles recebem a pasta do projeto como primeiro argumento.

Fluxo de trabalho

Faça uma lista de tarefas para estas etapas e trabalhe nelas em ordem.

Etapa 0: Definir o briefing

Encontre estes itens na solicitação. Pergunte apenas o que está faltando, uma pergunta, recomendação primeiro.

DecidirPadrão
Quem assiste, e em qual funçãoTécnico
Telefone ou desktopTelefone, 390 x 844
Qual fluxo, do início ao fimEsboço do Dave
Loja e modo de fluxo de trabalhoPergunte ao Dave. Veja Etapa 2.
Apenas imagens estáticas, ou estáticas mais clipesClipes onde a tela se move: gravação, carregamento, abrir e fechar
DuraçãoAbaixo de 2:30

Etapa 1: Storyboard em um canvas de design

Esta é a primeira coisa que Dave vê e o lugar onde ele edita o roteiro e as anotações.

  1. Crie a pasta do projeto e renderize quaisquer adereços (props/render-paper.mjs faz a ordem de reparo de papel de amostra).

  2. Explore o fluxo em busca de quadros-chave. Quadros-chave vêm do aplicativo real, então esta etapa precisa de uma execução de captura (Etapa 2 e Etapa 3, apenas estáticas). Copie examples/story-writer/capture-stills.mjs para o projeto e reescreva o fluxo. Olhe para cada quadro antes de continuar.

  3. Rascunhe storyboard.json. Um cartão por coisa que o espectador faz. Forma:

    { "id": "write-story", "part": 2, "img": "10-write-story",
      "title": "Toque em [[Write Story]]",
      "body": "O escritor de IA revisará suas anotações e escreverá 3Cs para você.",
      "boxes": [[183, 400, 191, 44]], "arrow": [162, 768],
      "footage": { "clip": "C-write", "runs": [[15, 336]], "note": "O que o clipe mostra" },
      "narration": "Quando estiver pronto, toque em Write Story." }
    

    boxes e arrow estão em pixels do telefone; a captura escreve a caixa de cada controle ao lado de seu quadro. [[Label]] desenha um chip de botão. Siga as regras de estilo abaixo desde o primeiro rascunho.

  4. Crie o canvas. Ferramenta de artefato: quickstart com intenção design, depois publique com a type_url que ele retorna e um título. Salve a url em <project>/storyboard/artifact.json.

  5. Carregue os quadros-chave para o canvas como ativos (JPEG, 1688 px de altura, preparados na área de rascunho para que vão em uma chamada). Registre cada url /_blob/... retornada sob assets em artifact.json, indexada pelo nome do quadro.

  6. Gere e publique. node scripts/storyboard-canvas.mjs <project> escreve storyboard/project/. Copie essa pasta para a área de rascunho e publique-a: canvas.json como file_path, cada .dc.html em files.

  7. Entregue o link para Dave e pare. Diga a ele: redigite quaisquer palavras em um cartão, a nota azul abaixo de cada cartão é a faixa de voz, arraste as anotações amarelas, escreva qualquer outra coisa em uma nota. Não comece a produção.

  8. Colha as edições dele. Artifact read com paths (o índice e cada prancheta) e um out_dir, depois node scripts/storyboard-harvest.mjs <project> <out_dir>. Leia o relatório para ele em palavras simples, aja sobre quaisquer notas que ele adicionou, depois execute novamente com --write.

  9. Mais uma rodada? Leia project/canvas.json de volta, regenere com --live <esse arquivo>, republique. Uma publicação que não começa do índice ao vivo é recusada.

Etapa 2: Pegue uma loja emprestada

O aplicativo deve estar no modo que o vídeo mostra. Apenas lojas de teste podem ser usadas.

LojaIdModo normalNotas
Summit Auto Group (demo)demo-dealershipfluxo de trabalho em equipeDemonstração de prospecção do Dave. Logins [email protected] (técnico), marcus@ (consultor), priya@ (peças). Usado para o primeiro vídeo.
Test Dealership 1mlTaPo12wbpUtJB9GXJMfluxo de trabalho em equipeCompartilhado com sessões de construção. Frequentemente ocupado.
  1. ListAgents, depois SendMessage para cada par: está usando a loja e precisa do modo? Aguarde a resposta. Se um par precisar, use a outra loja ou pergunte ao Dave.
  2. Leia o modo primeiro: NODE_OPTIONS='-r dotenv/config' npm run --silent manage-org -- info <id> da pasta do aplicativo.
  3. Altere-o apenas pelos minutos que uma captura leva, na mesma cadeia de comandos da captura e da restauração. Depois leia novamente e confirme.
  4. Nunca toque em uma loja de cliente. Nunca altere as preferências de uma conta de teste.

Etapa 3: Captura

  • Imagens estáticas: dpr: 3. Um quadro por cartão, tirado após a tela ter estabilizado.
  • Clipes: dpr: 2 com vt.recorder. Abra cada clipe com uma batida de quietude, mostre o marcador de dedo, depois aja. Leia marks.json para escolher footage.runs.
  • Ditado é real. vt.dictation reproduz um clipe de fala em um microfone falso; o aplicativo grava e transcreve. Imprima cada transcrição e leia-a: o transcritor reescreve números e nomes de marca.
  • Uma retomada precisa de uma ordem de reparo nova. Numere-as para cima e liste cada id em created-ros.txt.

Etapa 4: Slides

node scripts/build-slides.mjs <project> escreve out/slides/*.png, o PDF e as camadas que o vídeo precisa. Olhe para uma folha de contato de cada cartão. Verifique se nenhuma anotação cobre a coisa que ela aponta.

Etapa 5: Narração

cd /Users/davidsonders/ro-bot/app
NODE_OPTIONS='-r dotenv/config' node ~/.claude/skills/video-training/scripts/narrate.mjs <project>

Voz ash, modelo gpt-audio-1.5 (movido de gpt-4o-mini-tts, que a OpenAI desliga em 2027-01-06). Uma tomada cuja transcrição não corresponde às palavras do cartão é repetida, depois recusada. Dave aprovou esta voz e rejeitou as vozes integradas do Mac como robóticas. Usa a chave OpenAI do aplicativo e custa alguns centavos por compilação: diga isso no briefing de cada novo vídeo, para que o gasto nunca seja uma surpresa. DRY=1 lista o que seria regerado.

Escreva a narração para o ouvido: "R O", "três Cs", "tenthgear ponto A I". Anuncie cada parte em seu primeiro cartão.

Etapa 6: Vídeo

node scripts/build-video.mjs <project>. A velocidade é 1.25 ("Rápido" do QuickTime), o ritmo que Dave aprovou. Um cartão com um clipe dura o máximo entre sua narração e seu clipe.

Etapa 7: Verificar e dizer o que não foi verificado

  1. check-audio.mjs transcreve o vídeo e pontua cada cartão. Leia cada linha LOOK.
  2. Puxe um quadro de cada cartão que tenha um clipe ou uma seta e olhe para ele.
  3. Na devolução, declare claramente: não ouvido, não assistido do início ao fim.

Etapa 8: Entregar

Copie o vídeo, o PDF e out/slides/ para ~/Desktop/<Title>/. Mantenha versões anteriores. Dê a duração, o que mudou e qualquer coisa que Dave possa notar (um número de ordem de reparo diferente em um clipe, uma anotação sobreposta à filmagem).

Etapa 9: Limpeza

  • Modo da loja restaurado, depois lido de volta e confirmado.
  • node scripts/close-ros.mjs <project> <email> <org-id> fecha as retomadas. Excluir ordens de reparo é decisão do Dave.
  • Informe a qualquer par que você tenha mensagem que a loja está livre.

Regras de estilo (Dave, 2026-09-29)

RegraExemplo
Um botão que o espectador toca é desenhado como um botãoToque em [[New RO]]
Cabeçalhos de parte são curtos, sem "de 3"PARTE 2: HISTÓRIA DE GARANTIA
A capa não tem contagem de etapas
Um cartão por etapa. Mescle cartões que mostram uma decisão.Revisar e salvar são um cartão
Descarte um cartão cujo ponto é autoevidenteLendo Causa e Correção
Diga quem age e com o quê"Adicione uma nota de voz", não "Adicione uma nota"
Quando duas coisas na tela podem ser significadas, aponte para a que importaSeta no botão verde
Qualquer coisa que se mova no aplicativo deve se mover no vídeoForma de onda, spinner, cartão abrindo
Palavras de chão de fábricaRO, linha, história, 3Cs, CP

Dave dá edições de slide pelo número da página do PDF. Página 1 é a capa, então "pg 7" é etapa 6. Reafirme cada edição pelo nome da etapa antes de aplicá-la.

Critérios de sucesso

  • Dave editou o canvas do storyboard e suas edições foram colhidas, não adivinhadas
  • Cada quadro e clipe é o aplicativo real, no modo sobre o qual o vídeo trata
  • Slides, PDF e vídeo vêm todos do mesmo storyboard.json
  • Narração verificada por transcrição; linhas pouco claras nomeadas
  • A devolução diz o que não foi ouvido ou assistido
  • Modo da loja restaurado e confirmado; ordens de reparo de retomada fechadas
  • Pasta do projeto mantida fora da área de rascunho

Skills relacionadas

  • /visual para maquetes de telas que ainda não existem
  • /app-testing para as contas de teste e a estrutura de teste ao vivo que esta skill empresta
  • /compound depois, se uma captura expôs um bug do produto ou uma nova armadilha

Habilidades Relacionadas