Uma gravação pode fornecer vários trechos curtos, mas uma transcrição não decide se um recorte preserva o contexto, e uma exportação de 1080 × 1920 não prova que seja boa de assistir. Este guia usa cinco habilidades de projeto do Claude Code, acionadas manualmente, para organizar transcrição, classificação, corte, legendagem e renderização. Um editor humano aprova cada intervalo de origem e assiste a cada arquivo final. O processo se aplica a um vídeo seu ou com direitos expressos de edição e compartilhamento.

Esta receita se baseia na documentação e usa Terminal do macOS com zsh. A BIG CHANGE não executou os comandos, inspecionou filmagens privadas nem produziu os cinco arquivos. Confira a ajuda das ferramentas instaladas e sua mídia real antes de seguir. A imagem principal ilustra conceitualmente os cinco vídeos verticais que um criador revisaria. Não são trechos reais, saídas de software nem um teste da BIG CHANGE.

A grande mudança

  • O que mudou: As habilidades de projeto do Claude Code podem dividir uma edição local em cinco etapas acionadas manualmente. Os registros propostos conectam tempos da fonte, cortes aprovados, legendas corrigidas e arquivos finais; a documentação não demonstra que essa cadeia específica foi executada com sucesso.
  • Por que importa: Um criador com material autorizado pode dar ao editor uma decisão específica em cada etapa, inclusive se existem cinco trechos distintos. Essa estrutura permite rejeitar um corte fraco ou enganoso antes de exportá-lo com legendas.
  • O que observar: A decisão de compartilhar ainda depende dos direitos, da política de dados da conta Claude escolhida e da reprodução completa de cada MP4 salvo. Uma análise técnica aprovada não resolve essas questões.

Antes de começar

Você precisa de um arquivo local source.mp4 com áudio utilizável, armazenamento suficiente, acesso ao Claude Code, um executável local whisper.cpp funcionando whisper-cli e um modelo compatível com o idioma, além de FFmpeg e ffprobe com os codificadores e filtros necessários. Também precisa de um editor para conferir a gravação e as cinco exportações. Registre conta e política de dados do Claude Code, versões instaladas, commit ou compilação do whisper.cpp, SHA-256 e licença do modelo e limites de uso. Claude Code pode usar um modelo hospedado mesmo com transcrição e renderização locais. Conceda apenas o acesso a transcrições ou mídia permitido pelos direitos e pela política da conta. Suas instruções de habilidade não restringem acesso. Os controles de permissão das ferramentas são separados e regem as chamadas; conforme os ajustes, leituras comuns podem ocorrer sem confirmação. Examine expressamente o que a habilidade pode ler, além do que propõe escrever ou executar.

Coloque uma cópia imutável da fonte e rights.json em uma nova pasta local confiável para a execução. O registro de direitos deve identificar SHA-256 da fonte, editor, trechos e usos posteriores permitidos, permissões de participantes, músicas e imagens e regras de armazenamento e retenção. Não prossiga com direitos incertos. Abra Terminal nessa pasta, confira pwde crie as pastas de trabalho:

Terminal
mkdir -p transcript clips captions shorts probes .claude/skills/video-transcribe .claude/skills/video-rank .claude/skills/video-cut .claude/skills/video-caption .claude/skills/video-vertical
command -v claude
command -v ffmpeg
command -v ffprobe
claude --version
ffmpeg -version
ffprobe -version
ffmpeg -hide_banner -h encoder=libx264
ffmpeg -hide_banner -h encoder=aac
ffmpeg -hide_banner -h filter=subtitles
ffmpeg -hide_banner -h filter=scale

Defina WHISPER_CLI e WHISPER_MODEL como caminhos absolutos reais entre aspas. Defina LANGUAGE como o código verificado do idioma falado, como en somente se o áudio estiver em inglês. Confirme o suporte do modelo; um modelo exclusivamente inglês .en não cobre outro idioma. Idiomas mistos ou incompatíveis exigem um plano conferido antes de continuar. A referência CLI do whisper.cpp documenta -l, -m, -f, -osrt, -oj e -of; confira essas opções na ajuda da sua compilação. Não ative a opção de tradução.

Terminal
WHISPER_CLI='/absolute/path/to/whisper-cli'
WHISPER_MODEL='/absolute/path/to/approved-model.bin'
LANGUAGE='en'
test -x "$WHISPER_CLI"
test -r "$WHISPER_MODEL"
"$WHISPER_CLI" --help
ffprobe -v error -show_entries format=duration:stream=index,codec_type,codec_name,width,height,sample_aspect_ratio -of json source.mp4

Substitua os caminhos e o idioma de exemplo antes de executar. Confira duração, fluxos, orientação, áudio e espaço livre. Confirme que o filtro instalado subtitles tem suporte libass e que scale aceita force_original_aspect_ratio, force_divisible_by e reset_sar. Se faltar uma função, siga as instruções de compilação dos mantenedores e repita a verificação. Não elimine legendas silenciosamente.

Crie cinco habilidades de projeto delimitadas

No projeto confiável, salve cinco arquivos separados .claude/skills/<name>/SKILL.md . Cada um precisa de seu próprio name, description, disable-model-invocation: truee de regras completas de entrada, ação, saída e parada. Acione-os manualmente nesta ordem: /video-transcribe, /video-rank, /video-cut, /video-caption, /video-vertical. Não acrescente allowed-tools: Claude Code diz que esse campo concede uso sem confirmação das ferramentas listadas durante a invocação; ele não limita a habilidade a elas. Mantenha as permissões normais e revise o acesso. Uma leitura pode não perguntar, enquanto escritas e execução seguem os controles reais da conta.

Use os conteúdos completos abaixo com o registro compartilhado descrito a seguir. O texto da habilidade instrui Claude Code; não impõe uma barreira técnica de acesso.

.claude/skills/video-transcribe/SKILL.md

Markdown
---
name: video-transcribe
description: Transcribe the authorized local source for the five-short workflow.
disable-model-invocation: true
---

Input: rights.json, immutable source.mp4, checked source probe, verified language and local whisper.cpp executable/model. Confirm matching source and model hashes, usable audio and permitted access before any command.
Action: From the checked run directory, confirm source.wav and both transcript output paths do not exist. Extract mono 16 kHz 16-bit PCM source.wav with explicit first-audio mapping and no overwrite. Continue to whisper-cli only after a zero exit and valid WAV readback; use the verified model and explicit language, SRT and JSON output, and translation off. Inspect both outputs, parse source-relative times, and compare representative passages and uncertain names or quotes against source audio. Record a nonzero exit or uncertain output as a manifest blocker before any next stage.
Output: transcript/source.srt and transcript/source.json, recorded hashes, corrections or marked uncertainties, tool and model identity in manifest.json.
Stop: Missing rights, changed inputs, absent audio, empty or malformed transcript, or unverified relevant speech. Do not upload, publish or overwrite accepted files; ask the editor to settle uncertainty.

.claude/skills/video-rank/SKILL.md

Markdown
---
name: video-rank
description: Suggest source moments for human selection of five distinct clips.
disable-model-invocation: true
---

Input: Checked source transcript and hash, immutable source hash and probe duration, rights.json, intended audience. Verify all identities and authorized transcript access.
Action: Suggest more than five moments with numeric source-second start/end, source words, surrounding context and editorial rationale. Treat ranking as a suggestion, never a viral forecast. Have the editor open each candidate in the original and check speaker, wording, facts, context and rights. Record exactly five distinct coherent approved intervals and a rejected-candidate log.
Output: approved-moments.json with order, source hash and five numeric bounds satisfying 0 <= start < end <= source duration.
Stop: Fewer than five permissible, meaningful moments, mismatched hashes, uncertain bounds or missing human approval. Do not invent a fifth excerpt.

.claude/skills/video-cut/SKILL.md

Markdown
---
name: video-cut
description: Cut the five approved source intervals into separate local clips.
disable-model-invocation: true
---

Input: Immutable source.mp4, source hash/probe and five human-approved intervals. Verify hashes and calculate each duration as end minus start.
Action: For each 01-05, confirm its unique output path is unused, then transcode the approved source-relative interval with input -ss, -t duration, explicit first video/audio mapping, libx264, AAC and -n. Continue only on zero exit and file readback. Probe streams and duration, inspect first and last frames, and have the editor watch each whole cut for boundaries, sync and context. Record the exact command and output hash. Any failure or uncertain write is a manifest blocker; never pass that clip to captioning.
Output: Five accepted numbered clips, individual probe records and links to approved intervals in manifest.json.
Stop: Wrong bounds, absent stream, drift, misleading context, output collision or uncertain command result. Read back the existing path first; correct bounds with human approval and use a new filename. Never overwrite or reuse an old clip hash.

.claude/skills/video-caption/SKILL.md

Markdown
---
name: video-caption
description: Create and check local captions from each accepted clip.
disable-model-invocation: true
---

Input: Five accepted clip hashes, verified language and local model identity. Reject stale clips or mismatched source links.
Action: For each actual numbered clip 01-05, verify its accepted hash and unused WAV/raw-SRT paths, then extract its own mono 16 kHz 16-bit PCM WAV with -n. Run whisper-cli only after zero exit and WAV readback, with the matching language and SRT output; translation stays off. Preserve raw SRT. Have the editor correct words, names, numbers, cue timing, overlaps and readability against the actual clip, then save a distinct .checked.srt. Use clip-local times, not source-offset cues. Record failures as blockers before rendering.
Output: Five checked SRTs with raw-ASR and exact clip hash links in manifest.json.
Stop: Any cue outside clip duration, uncertain speech, bad alignment or stale clip hash. Repair and replay before rendering; a recut requires matching new captions.

.claude/skills/video-vertical/SKILL.md

Markdown
---
name: video-vertical
description: Render and review five captioned 1080x1920 MP4s.
disable-model-invocation: true
---

Input: Five accepted clip hashes/probes, matching checked SRT hashes, rights record and a human-approved crop or framing plan for each clip.
Action: Check decoded orientation and sample aspect ratio. Choose even integer crop width, height and x/y for each clip; require positive dimensions, nonnegative offsets and a rectangle within the decoded frame. A fixed crop does not track motion. Verify unique output and probe paths are unused. From the established run directory, render each separately with crop, aspect-preserving scale, pad, clip-local subtitles, explicit video/audio mapping, libx264, yuv420p, AAC and -n. Continue only on zero exit and saved-file readback. Create probe JSON without clobbering an existing path, reopen the MP4 and have the editor watch its entire video and audio, checking cut context, every caption, framing, sync, facts and rights. Record any failure or uncertain output as a blocker.
Output: Five distinct accepted 1080x1920 MP4s, hashes, probe JSON, exact source/clip/SRT lineage and UTC human acceptance notes.
Stop: Unknown orientation, invalid crop, missing filter, collision, unreadable file, silent audio, cut-off text, wrong duration, bad context or failed full playback. Inspect uncertain existing outputs; revise to a new filename, probe and watch again. No upload or publishing.

Mantenha um único manifest.json para a execução. Em cada passagem registre direitos e SHA-256 imutável da fonte, versões das ferramentas, SHA-256, licença e idioma do modelo, entradas e saídas com SHA-256, intervalos numéricos aprovados, comandos exatos e decisões UTC. Se um arquivo identificado ou hash divergir, pare e resolva antes da próxima habilidade.

Trate cada bloco de comandos como uma etapa em um novo script zsh ou shell controlado, com set -e para que uma falha interrompa a etapa. Confira se cada caminho de saída está livre antes de executar. Registre saídas não zero, arquivo ausente ou escrita incerta como bloqueio no manifesto. A próxima habilidade deve ler esse estado e o hash de saída; não pode aceitar um corte com falha porque um trecho antigo existe.

1. Transcreva a fonte

O README dos mantenedores do whisper.cpp informa que o exemplo CLI atualmente exige WAV de 16 bits. Com o áudio confirmado, execute o seguinte na pasta de projeto verificada. -n impede que FFmpeg sobrescreva um WAV existente.

Terminal
set -e
test ! -e source.wav
test ! -e transcript/source.srt
test ! -e transcript/source.json
ffmpeg -i source.mp4 -map 0:a:0 -ar 16000 -ac 1 -c:a pcm_s16le -n source.wav
test -s source.wav
"$WHISPER_CLI" -m "$WHISPER_MODEL" -f source.wav -l "$LANGUAGE" -osrt -oj -of transcript/source
test -s transcript/source.srt
test -s transcript/source.json

Confirme que transcript/source.srt e .json existem, contêm fala com tempos e permanecem dentro da duração de origem medida. Ouça passagens representativas e verifique nomes, números e citações incertos no original. Guarde uma transcrição corrigida ou marcas explícitas de incerteza. Se extração ou transcrição ficar vazia, examine fluxo, executável, idioma e compatibilidade do modelo antes de tentar nova saída com nome único.

2. Selecione cinco momentos do original

Acione /video-rank com a transcrição conferida e o público. Peça mais de cinco candidatos para permitir rejeitar trechos fracos. Exija segundos numéricos de início e fim desde o começo da fonte, fala, contexto anterior e posterior e motivo da compreensão independente. Abra cada intervalo no original. O editor decide se participante, palavras, contexto visual, fatos e permissões sobrevivem ao corte. Salve exatamente cinco intervalos distintos aprovados em approved-moments.json; inclua ordem, hash de origem e 0 <= start < end <= source duration. Uma passagem transcrita serve apenas para localizar. Para a tarefa mais restrita de encontrar tempos, veja Encontre o momento falado antes de editar um vídeo.

Se a gravação não tiver cinco momentos defensáveis, pare. A tarefa de cinco arquivos continua incompleta.

3. Corte os intervalos aprovados

Acione /video-cut. Para cada intervalo, calcule DURATION = END - START pelos limites numéricos aprovados. Substitua os marcadores entre sinais angulares por números reais; eles não são valores executáveis. Repita com clip-02.mp4 até clip-05.mp4. FFmpeg documenta busca na entrada, duração, seleção explícita de fluxos e saída sem sobrescrita. Transcodifique em vez de copiar diretamente os fluxos para os limites de corte pretendidos.

Terminal
set -e
test ! -e clips/clip-01.mp4
ffmpeg -ss <START_SECONDS> -i source.mp4 -t <DURATION_SECONDS> -map 0:v:0 -map 0:a:0 -c:v libx264 -c:a aac -n clips/clip-01.mp4
test -s clips/clip-01.mp4

Analise fluxos e duração de cada trecho real, confira primeiro e último quadro e assista a ele inteiro. Registre hash e intervalo aprovado. Um corte errado exige novos limites aprovados e outro nome de saída. Se houver falha ou incerteza, examine o arquivo existente e a análise antes de repetir; nunca direcione uma repetição ao mesmo nome.

4. Corrija as legendas em cada corte real

Acione /video-caption. Transcreva cada trecho aceito, pois as legendas precisam começar no tempo zero desse trecho. Para o trecho 01, os comandos são:

Terminal
set -e
test ! -e captions/clip-01.wav
test ! -e captions/clip-01.srt
ffmpeg -i clips/clip-01.mp4 -map 0:a:0 -ar 16000 -ac 1 -c:a pcm_s16le -n captions/clip-01.wav
test -s captions/clip-01.wav
"$WHISPER_CLI" -m "$WHISPER_MODEL" -f captions/clip-01.wav -l "$LANGUAGE" -osrt -of captions/clip-01
test -s captions/clip-01.srt

Repita com o número real de dois dígitos de 02 a 05 e caminhos distintos. Preserve cada arquivo bruto captions/clip-NN.srt. O editor compara cada entrada com o trecho, corrige palavras, nomes e números, confere tempos e legibilidade e salva captions/clip-NN.checked.srt. Uma entrada além da duração bloqueia a renderização. Vincule cada hash SRT ao hash do trecho. Se o corte mudar, gere novamente ou reconfira as legendas no novo arquivo.

5. Reenquadre, renderize e aceite os cinco

Acione /video-vertical. Para cada trecho aceito, examine imagem decodificada, orientação, proporção do pixel e movimento. O editor escolhe para cada trecho seus próprios inteiros pares CROP_W, CROP_H, CROP_X, CROP_Y. O retângulo deve caber no quadro decodificado. Um recorte fixo não acompanha o assunto em movimento; se perder conteúdo essencial, escolha um plano revisado de escala com margens ou altere o corte. Rotação ou coordenadas incertas interrompem a renderização. O manual de filtros FFmpeg documenta crop, scale, pad e o filtro subtitles baseado em libass.

Na pasta estabelecida, defina CLIP como o número real de dois dígitos e as quatro variáveis de recorte com os inteiros aprovados para aquele trecho. O comando é um modelo, não um exemplo testado. Mantenha o caminho relativo simples das legendas mostrado; caracteres especiais em nomes precisam de escape próprio no grafo de filtros. Repita separadamente de 02 a 05.

Terminal
set -e
setopt noclobber
CLIP=01
CROP_W=<CHECKED_EVEN_INTEGER>
CROP_H=<CHECKED_EVEN_INTEGER>
CROP_X=<CHECKED_EVEN_INTEGER>
CROP_Y=<CHECKED_EVEN_INTEGER>
test ! -e "shorts/short-${CLIP}.mp4"
test ! -e "probes/short-${CLIP}.json"
ffmpeg -i "clips/clip-${CLIP}.mp4" -map 0:v:0 -map 0:a:0 -vf "crop=${CROP_W}:${CROP_H}:${CROP_X}:${CROP_Y},scale=1080:1920:force_original_aspect_ratio=decrease:force_divisible_by=2:reset_sar=1,pad=1080:1920:(ow-iw)/2:(oh-ih)/2,subtitles=captions/clip-${CLIP}.checked.srt" -c:v libx264 -pix_fmt yuv420p -c:a aac -n "shorts/short-${CLIP}.mp4"
test -s "shorts/short-${CLIP}.mp4"
ffprobe -v error -show_entries format=duration:stream=index,codec_type,codec_name,width,height,sample_aspect_ratio -of json "shorts/short-${CLIP}.mp4" > "probes/short-${CLIP}.json"
test -s "probes/short-${CLIP}.json"

Em cada um dos cinco JSON de análise, exija vídeo a 1080 × 1920 com proporção de pixel 1:1, áudio e duração positiva coerente com o corte aprovado após arredondamento da codificação ou dos quadros. Valor ausente ou desconhecido continua sem solução. A saída JSON do ffprobe verifica propriedades, não a qualidade da edição. Reabra e assista a cada MP4 inteiro, comparando com o intervalo de origem, o corte aceito e o SRT conferido. Confira limites das frases, legendas e posição segura, enquadramento no movimento, sincronização, fatos e direitos. Registre aceitar, revisar ou rejeitar com hora UTC no manifesto. Cinco arquivos aceitos, cada um ligado a hash da fonte, intervalo aprovado, hash do trecho, hash SRT e JSON de análise, completam a tarefa. Quatro não bastam.

Limites e recuperação

O acesso ao Claude Code pode envolver plano ou cobrança de API e limites de uso. Modelo local baixado, transcrição, transcodificação e revisões consomem armazenamento e computação. Registre cobranças reais se a conta as mostrar; custo desconhecido não é zero. Não foram medidos velocidade, precisão, qualidade de legendas, economia ou popularidade desta receita.

Preserve original e materiais aceitos. Diante de modelo ausente, opção incompatível, transcrição ruim, falha de renderização ou escrita incerta, confira primeiro hashes exatos e arquivo existente. Corrija a causa, dê nova rota à revisão e repita análise e reprodução completa. Não envie nem compartilhe um curta até o editor aceitar conteúdo e direitos.