/new-edit-style
Vídeos de referência entram, uma skill /<style>-edit travada sai, para que toda edição feita com ela se pareça com as
referências. Este é o processo que construiu /kallaway-edit, escrito e aprimorado. A pessoa
que o usa geralmente NÃO é técnica: inglês simples, uma mensagem curta por etapa, nunca a faça tocar em código.
SK = ${CLAUDE_SKILL_DIR}, a pasta desta skill. ENGINE = ${CLAUDE_SKILL_DIR}/../kallaway-edit,
a skill de edição comprovada na qual ela se baseia (carrega o assistente de configuração, transcrição, corte, recorte, som,
construção, renderização e QA). Nunca escreva dentro de SK ou ENGINE: uma atualização substitui ambos.
DATA = $HOME/.claude-video-editor, a pasta do editor que sobrevive a atualizações (configurações, Python, efeitos
sonoros, cache de fontes). ROOT = a pasta do projeto (projectRoot em DATA/config.json).
Execute cada script através de um destes, exatamente como escrito, para que encontre as configurações do usuário:
PY = VIDEO_EDITOR_DATA="$HOME/.claude-video-editor" "$HOME/.claude-video-editor/venv/bin/python" -I
SYS = VIDEO_EDITOR_DATA="$HOME/.claude-video-editor" python3 -I (antes da configuração ser executada)
STYLE = nome curto em kebab-case ("kallaway"). SDIR = ROOT/references/<STYLE>/.
WORK = ROOT/work/new-edit-style/<STYLE>/ (os PNGs de progresso vão em WORK/progress/, numerados).
Regras rígidas
- Apenas ferramentas gratuitas (ffmpeg, Python, faster-whisper, HyperFrames, fontes OFL). Sem APIs pagas, sem logins.
Baixe os links de referência desconectado (
yt-dlp --no-cookies); nunca use os cookies de um navegador. - Nunca toque nos arquivos originais do usuário; nunca delete nada (mova versões antigas para
ROOT/archive/). - Nunca execute
npx hyperframes initounpx hyperframes skills; nada pode ser adicionado a~/.claude/skillsou~/.agents/skills. - Nunca apresente um palpite como medido, ou um som como ouvido. Agentes não podem ouvir; a verificação do ouvido do usuário decide.
- Copiar um ESTILO de edição é permitido; nunca copie as filmagens, logotipos, música ou texto do criador em uma edição.
- Subagentes: um por vídeo de referência para as análises (Sonet é suficiente), no máximo 3 ao mesmo tempo, instruídos
com
references/breakdown-brief.md. Tudo que precisa de julgamento ou olhos, você faz você mesmo.
Fluxo de trabalho
0. Configuração (apenas na primeira vez)
Se DATA/config.json não tiver "setupComplete": true, execute primeiro o assistente de configuração do editor: invoque a
skill kallaway-edit com setup (ou leia o passo 0 de ENGINE/SKILL.md, onde
${CLAUDE_SKILL_DIR} significa ENGINE e $HOME/.claude-video-editor significa DATA): verificação do Claude Code,
verificação de ferramentas, pastas do projeto, instalação. Se ENGINE estiver faltando, diga: "Isso precisa da skill
kallaway-edit instalada ao lado dela (ela carrega o mecanismo de edição).
Reinstale ambas de https://github.com/learnaiwithhugo/video-editor-skills, depois execute /new-edit-style
novamente." Então pare. Esta skill também precisa de yt-dlp (ela baixa os vídeos de referência), então sempre
verifique com SYS "ENGINE/scripts/setup.py" --check --for new-edit-style, na primeira execução e nas
seguintes. Se yt-dlp estiver faltando, forneça ao usuário a linha de correção (brew install yt-dlp, colada
no aplicativo Terminal), espere até que ele diga que está pronto e verifique novamente.
1. Captura (~2 min)
Pergunte, em uma mensagem: "Envie-me 2 ou 3 vídeos (links ou arquivos) de UM criador cuja edição você queira
copiar, idealmente suas edições favoritas, e um nome curto para o estilo." 3 é o ideal: as regras vêm
do que todos eles compartilham. Então:
SYS "SK/scripts/fetch.py" STYLE "ROOT" <link ou arquivo> ... -> SDIR/STYLE-1.mp4 ...
Diga: "Recebidos. Medindo cada quadro agora (cerca de 2 minutos)."
2. Preparação, tudo scriptado (~30 s por vídeo)
PY "SK/scripts/prep.py" "SDIR" SDIR/STYLE-*.mp4
Por vídeo em SDIR/prep/<reel>/: transcrição com tempo das palavras, varredura de corte a cada quadro, folhas de contato
4 qps com tempos, stills em tamanho real, espectrograma, detecção de efeitos sonoros estéreo, volume e fingerprint.json (os
números de estilo medidos). Mais SDIR/style-check.png e SDIR/style-spec.json.
Olhe para style-check.png agora. Se um vídeo claramente não compartilha a aparência dos outros (layout diferente,
legendas, cores), informe o usuário e peça uma substituição antes de gastar agentes. Copie-o para
WORK/progress/01-style-check.png.
3. Análises, um agente por vídeo, em paralelo (~15 min)
Preencha references/breakdown-brief.md uma vez por vídeo e lance-os em uma mensagem. Cada um escreve
SDIR/prep/<reel>/edit-log.md. Enquanto eles executam, faça a correspondência de fonte da etapa 4.
4. Correspondência de fonte (~20 s)
PY "SK/scripts/font_match.py" SDIR/STYLE-1.mp4 SDIR/prep/STYLE-1/transcripts/STYLE-1.words.json "SDIR/font"
Olhe para font-match.png: o vencedor deve corresponder visivelmente. Execute em um segundo vídeo se os dois primeiros
estiverem dentro de 0,01. (Kallaway: Archivo 800 a -0,045 em pontuou 0,773, acima de Helvetica Neue Bold com 0,759.)
5. Mesclar no guia de estilo (você, ~10 min)
Siga references/merge-guide.md: regras de consenso, números medidos, uma folha de quadros-chave que você olha
você mesmo, e a seção de filmagem. Saída SDIR/STYLE-style-guide.md + SDIR/STYLE-key-frames.png.
Abra a folha de quadros-chave para o usuário e dê a ele o resumo de um parágrafo.
6. Criar a skill de estilo (~2 min + sua reescrita, ~30 min)
SYS "SK/scripts/make_style_skill.py" STYLE "SDIR" --title "Nome de exibição"
Ela clona o mecanismo comprovado (ENGINE, encontrado ao lado desta skill) em ROOT/.claude/skills/STYLE-edit/:
uma skill de projeto na própria pasta de vídeo do usuário, nunca na pasta global de skills, para que as atualizações nunca a toquem.
A cópia compartilha DATA (sem segunda instalação). Ela adiciona as ferramentas de correspondência (scripts/match/),
escreve style.json a partir da especificação medida e imprime a lista de verificação de
arquivos de estilo para reescrever a partir do guia de estilo (regras de estilo SKILL.md, style-rules.md, graphics-recipes.md,
sound-map.md, filming-guide.md, o kit CSS/JS e os layouts de build.py apenas se o estilo tiver
layouts diferentes). Reescreva cada item na lista. Os scripts do mecanismo permanecem intocados, a menos que um layout precise.
7. Travar o estilo (~45-60 min)
Siga references/lock.md: uma edição de teste na filmagem do usuário -> pontuação de correspondência -> corrigir -> recriação
dourada de uma janela de referência -> corrigir -> uma rodada de crítica -> verificação do ouvido -> aprovação. Registre cada número
em STYLE-edit/references/lock-log.md.
8. Entregar
Diga ao usuário: o novo comando (/STYLE-edit, disponível sempre que o Claude Code for aberto em ROOT; se não
aparecer ainda, reinicie o Claude Code lá), o que ele faz em um parágrafo, a pontuação de correspondência e os
números dourados, como filmar para ele (3-4 tópicos da seção de filmagem) e o que ainda não corresponde.
Tempos (em um M4 Pro Mac, 3 vídeos de ~1,5 min)
Captura 1 min · preparação 1,5 min · análises 15-18 min (paralelo) · correspondência de fonte 20 s · mesclagem 10 min · criar skill 2 min + reescrita 30 min · trava 45-60 min. Cerca de 2 horas de ponta a ponta, principalmente agentes e renderizações.
Arquivos
scripts/: fetch.py, prep.py, fingerprint.py (medição / especificação / pontuação), font_match.py, golden.py,
make_style_skill.py, engine.py (encontra ENGINE). references/: breakdown-brief.md, merge-guide.md,
lock.md. templates/: style-rules.md, graphics-recipes.md, lock-log.md (copiados para novas skills de estilo).