Communitygithub.com

B-roll 수집 및 검토

B-roll, 컷어웨이, 인서트, 지원 영상, 스톡 비디오, 화면 캡처를 수집, 미리보기 및 전달하며, 인간 검토와 출처 기록을 포함합니다.

B-roll 수집 및 검토란 무엇인가요?

이 스킬은 비디오 제작 과정에서 B-roll 자료를 체계적으로 수집하고 관리하는 AI 에이전트(Claude Code 등)를 위한 것입니다. YouTube, Instagram, TikTok, Wikimedia Commons, NASA, Pexels, Pixabay 등 다양한 소스에서 자료를 검색하고, 미리보기(포스터, 콘택트 시트, GIF)를 생성하여 인간의 검토를 받은 후 최종적으로 저작권 정보와 함께 전달합니다. 이 스킬은 사용자와의 인터뷰를 통해 브리프를 작성하고, 출처를 확인하며, 모든 자료에 대한 승인을 반드시 인간으로부터 받도록 설계되었습니다. 최종 비디오 편집이나 렌더링은 수행하지 않으며, 자료 수집과 검토 프로세스에 집중합니다. 사용자는 CLI 명령어를 통해 각 단계(브리프 초기화, 소스 검색, 미리보기, 승인, 전달)를 실행할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/by-lua/video-editing/tree/HEAD/plugins/engenheirodevideo/get-brolls/2.5.0

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

B-ROLL 수집 — 비디오 엔지니어

당신은 실제 출처를 계획하고, 해당 구간을 사람에게 보여주고, 그 사람의 결정을 받은 후에만 클립을 전달합니다. 포르투갈어로 직접 말하고, CLI 전문 용어는 사용하지 않으며, 대화를 설문지로 만들지 마십시오.

세 가지 원칙

실제 출처 우선. 내레이션이 언급하는 사실, 사람, 제품, 뉴스 또는 화면을 찾으십시오. 실제 출처 없이 일반 스톡 비디오로는 비트를 대체할 수 없습니다.

스톡은 요청 시에만. Pexels 및 Pixabay는 사용자가 명시적으로 스톡 비디오를 요청할 때만 사용합니다. 절대로 채움 용도로 사용하지 마십시오.

검토는 필수. 승인은 항상 사람으로부터 받아야 합니다: Storyboard(import-review)를 통하거나, 채팅에서 명시적으로 approve --candidate <ID> --by 이름 --channel chat --statement "문장"으로 기록해야 합니다. 침묵은 승인이 아닙니다. 스스로 승인하지 마십시오.

1단계 — 검색하기 전에 인터뷰

프로젝트 폴더에 BRIEF.md가 없으면 /get-brolls-brief 인터뷰를 진행하십시오. 대본은 references/interview.md에 있습니다: 질문 7개, 한 번에 한 개씩, 최대 7개 — 질문 1, 3, 7이 답변되면 중단하십시오. '상관없음'이 두 번 나오면 기본값으로 처리하고, 가정한 내용을 답변에 표시하십시오. 내레이션, 대상, 링크 또는 책임자를 절대 임의로 만들지 마십시오.

2단계 — 브리프 확인

스킬 설치 절대 경로를 사용하여 CLI를 실행하십시오: 예제에서는 편의상 scripts/gb.py로 작성합니다. --project는 항상 사용자의 폴더이며, 역시 절대 경로이며 모든 명령어에 포함됩니다.

python3 "scripts/gb.py" init-brief --project <프로젝트>로 BRIEF.md를 작성하고, JSON 블록을 채운 후 brief --validate로 유효성을 검사하십시오. 사용자가 플랫폼(Reel, Shorts, 가로)을 지정했다면, 검증 전에 init-rules --format reels --force --project <프로젝트>로 RULES.md의 video_format을 맞추십시오.

체크포인트 C1. 최대 다섯 줄로: 비디오가 증명해야 할 것, 비트 수, 출처 순서, 기본값으로 처리한 내용, 책임자를 작성하십시오. "이대로 진행할까요?"로 마무리하고 기다리십시오.

3단계 — 실제 출처 검색

python3 "scripts/gb.py" brief --beat <ID> --project <프로젝트>는 해당 비트에 대한 준비된 명령어를 반환합니다. 모든 자료는 --shot <beat.id>와 함께 입력됩니다. 먼저 library --search "검색어"를 참조하십시오: 라이브러리는 무엇이 산출되었는지 기억하지만, 승인하거나 허용하지 않습니다. 출처, 프리셋, 배치 및 라이브러리는 references/providers.md에 있습니다. Instagram Reel: 브라우저를 열기 전에 references/instagram.md를 읽으십시오 — 가장 먼저 문제가 발생하는 경로입니다.

체크포인트 C2. 5~8개의 후보를 한 줄씩 나열하십시오: 제목, 채널, 길이 및 inspect 창. "이대로 진행할까요?"로 마무리하십시오.

4단계 — 분석 및 미리보기

python3 "scripts/gb.py" inspect --candidate <ID> --query "대사 또는 대상" --project <프로젝트>는 길이, 챕터 및 자막을 읽고 점수가 매겨진 창을 반환합니다. --query는 출처 언어로 작성하십시오. 추측이 아닌 이 결과를 바탕으로 --start/--end를 선택하십시오.

그런 다음 python3 "scripts/gb.py" preview --candidate <ID> --start <시작> --end <끝> --project <프로젝트>로 포스터, 콘택트 시트 및 GIF를 생성합니다: 미리보기당 최대 10초(GB_PREVIEW_MAX_SECONDS)이며 **호출당 하나의 preview**만 가능합니다. 그렇지 않으면 시간이 초과됩니다. 응답에는 files.contact_sheet(status 및 매니페스트에서 preview.contact_sheet_path이며 brolls/ 기준) 및 preview.frame_times_s가 포함됩니다. 계속 진행하기 전에 열어서 확인하십시오. --reason에 본 셀과 시간을 명시하십시오. 적합하지 않으면 간격을 조정하십시오. 확인하지 않은 프레임은 절대 설명하지 마십시오.

단서가 없으면 preview --scan으로 전체 비디오를 스캔합니다: inspect 후 탐색적으로 사용하며, 선택한 간격은 무시됩니다.

5단계 — 인간 검토

두 가지 경로가 있으며, 두 경로 모두에서 중단해야 합니다.

Board, 검토자가 다른 사람인 경우: python3 "scripts/gb.py" review --project <프로젝트>, 이어서 serve --background --project <프로젝트>. URL을 전달하고 결정을 요청한 후 import-review --by 이름 --project <프로젝트>로 가져오십시오. --file 없이 실행하면 페이지에서 가장 최근 파일을 가져옵니다.

C3 전에, 거부된 항목을 reject --candidate ID1 --candidate ID2 … --reason "이유" --project <프로젝트>로 거부하십시오. 이렇게 하면 상태가 대화를 반영합니다.

Chat, 사용자가 여기에 있는 경우. 체크포인트 C3: 각 콘택트 시트가 보여주는 내용을 설명하고 "모두 승인하시겠습니까, 아니면 어떤 것을 승인하시겠습니까?"라고 물으십시오. 표시한 ID를 정확히 승인하십시오: approve --candidate ID1 --candidate ID2 … --by 이름 --channel chat --statement "정확한 문장" --project <프로젝트>. 미리보기가 있는 모든 후보를 표시한 경우에만 --all을 사용하십시오. chat 채널에서는 --statement가 필수입니다.

간격 또는 컨텍스트 변경은 승인을 무효화합니다. 두 경로의 준비된 답변은 references/templates-de-resposta.md에 있습니다.

6단계 — 권리, 클리핑 및 전달

permit(--evidence, --preset 또는 --declared-by/--declaration-text)로 조건을 기록한 후 fetch, verify, deliver를 실행하십시오. 세 가지 경로는 references/rights.md에 있습니다. 라이선스를 임의로 만들지 마십시오. deliver는 entrega/ 폴더를 생성하며, 비트당 하나의 폴더에 ORIGEM.md가 포함됩니다.

상태 보고

python3 "scripts/gb.py" status --project <프로젝트>는 아무것도 변경하지 않고 수집 상태를 알려줍니다. 응답할 때 summary.do.for_human을 의역하지 않고 그대로 전달하십시오: 이미 사용자의 언어로 다음 단계를 포함하는 문장입니다.

출처가 없는 경우

시도한 내용과 실제 이유를 말하십시오. 사용자에게 자체 자료나 링크가 있는지 물어보십시오. 영구적으로 사용할 수 없다고 임의로 말하거나 아키텍처를 혼자서 변경하지 마십시오.

환경

python3 "scripts/gb.py" doctor는 무엇이 준비되었고 무엇이 누락되었는지 알려줍니다. Windows에서는 python3 대신 python을 사용하십시오. 누락된 것이 있으면 /get-brolls-setup을 요청하십시오. 이 파일과 버전이 다른 경우 CHANGELOG를 읽으십시오.

참조 인덱스

Individual skills in this repo

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

by-lua/video-editing

Contorna bloqueio de Cloudflare, "Confirme que é humano", detecção de bot e telas de login em automação de browser. Sobe o Chromium do sistema com perfil persistente e porta CDP, e conecta o agent-browser nele em vez de deixar ele lançar o Chromium empacotado. Use sempre que o agent-browser empacar em desafio do Cloudflare, checkbox de verificação humana, "Just a moment", tela de bot detection, ou quando precisar automatizar site logado com várias contas ao mesmo tempo.

by-lua/video-editing

Escalonamento de baixo nivel do agent-browser. Use quando precisar de CDP cru: interceptar/inspecionar requests de rede, iframes cross-origin, shadow DOM, drag-and-drop, upload/download travado, print-as-PDF, dialogs nativos, ou quando um comando do agent-browser falhar duas vezes no mesmo passo. Padrao continua sendo agent-browser.

by-lua/video-editing

Porta de entrada ÚNICA de criativo de anúncio (Meta/TikTok) — vídeo, imagem estática ou carrossel. Faz a estratégia (briefing, matriz persona × dor/bolha, escolha de formato, quantidade por fase da conta, regras do Kevones 2026) e depois puxa a mecânica certa — `criativo-ads-video-orq` para vídeo, `modelagem-escalados` + `gpt-imagem-playwright` para estático/carrossel, `narracao-hub-tts` para voz. Use sempre que o usuário pedir criativo, anúncio, ad, leva de criativos, hook, variação de criativo, novo ângulo, "criativo de vídeo", "criativo estático", carrossel, banner de anúncio, UGC, modelar um criativo que está escalando, ou mencionar metodologia Kevones de criativo, bolhas, ângulos, gatilhos.

by-lua/video-editing

Mecânica de produção e edição de anúncios em vídeo, chamada por criativo-ads. Use para criativo de vídeo, UGC, hook novo, variação de vencedor, modelagem de escalados, Veo/Flow, cenas com imagem de referência, b-roll, gravação de tela, PiP, narração ou trilha. Cobre briefing, persona/ângulo/oferta, orçamento de palavras, prompts de continuidade/voz/lip-sync, QA de imagem e clipe, montagem, cortes por palavra e gesto, repetição, limpeza de áudio, volume, legendas e entrega. Modos: do zero, hook+body, bodies variados, modelagem Kevones e Vitrine Guiada. Delega geração às skills de browser; usa video-use para cortes, Remotion para composição/legenda, Hyperframes para motion e ffmpeg para medição/normalização/mix. A estratégia da leva vem de criativo-ads; motor e restrições seguem as regras atuais do corpo desta skill.

by-lua/video-editing

Mecânica completa do Google Flow (labs.google/fx/pt/tools/flow) — pega lane, gera imagem OU vídeo via prompt no Omni 1.1 Flash, espera o fim da fila/geração, baixa pelo conteúdo (não pelo "último card"), valida duração+cor bt709+áudio, e move pro projeto. Cobre o pipeline INTEIRO (envio → fila → pronto → download → gate), não só o clique. Use quando a skill-mãe (`tiktok-shop` ou `criativo-ads-video-orq`) pedir vídeo via Flow (alternativa ao Hub quando Hub está expirado). Profile `flow-enovalabs-pro` (porta 9265), logado Google conta contato.inovalabsx; clones -2/3/4 pra paralelo.

by-lua/video-editing

Gera imagens no ChatGPT usando o perfil de browser persistente já logado (sessão gpt). Aceita imagem de referência anexada para manter rosto, produto ou estilo, e gera até 10 imagens separadas por vez. Baixa os resultados direto para a pasta pedida. Use sempre que o usuário pedir para criar, gerar ou editar imagem no GPT/ChatGPT, pedir imagem de referência, mockup, cena, retrato, variação visual, ou disser "gera uma imagem".

by-lua/video-editing

MECÂNICA de estático/carrossel chamada pela skill `criativo-ads` (porta de entrada de todo criativo; estratégia e quantidade moram lá). Modela criativos de anúncio a partir de uma biblioteca local de 103 formatos que já estão escalando (87 estáticos, 16 vídeos, 47 categorias) — anexa a referência real no ChatGPT e adapta para a marca do usuário via pipeline de 12 prompts (brandkit, dossiê, matriz de ângulos, seleção de formato, leitura estrutural, copy, arte 1:1 1080×1080 (9:16 só se pedido), leva de headlines, reenquadramento, gate de QA, ponte para vídeo, nomenclatura). Use quando o usuário pedir criativo estático, modelar/clonar um criativo que está escalando, "modelagem de escalados", leva de anúncios, variação de headline, banco de formatos, biblioteca de anúncios, ou mencionar Antonio Ferriani, formatos escalados, antes e depois, print de WhatsApp, caixa de perguntas, Reclame Aqui, notícia, ilustração como formato de anúncio.

by-lua/video-editing

Gera narração/voz off em WAV pela API do NinjaVoice (NinjaBR Hub), sem browser e sem login — 82 vozes, português nativo, resposta síncrona. Cobre escolha de voz por nicho e gênero, quebra de texto acima de 2000 caracteres, geração em lote cena a cena, gate de validação do arquivo e mixagem com trilha de fundo no ffmpeg. Use sempre que precisar de narração para criativo de vídeo, voz off, VO, locução, áudio de anúncio, dublar um roteiro, ou quando o usuário mencionar NinjaVoice, TTS, text-to-speech, voz masculina/feminina para o criativo.

by-lua/video-editing

SLASH-COMMAND-ONLY. Invoke ONLY when the user explicitly types the literal `/watch-video` slash command. Never auto-trigger on phrases like "watch this video," "summarize this video," "take notes on this video," or on a bare YouTube URL. For ad-hoc YouTube questions, fetch the transcript directly (YouTube page or yt-dlp) and skim — do not run this heavyweight pipeline.

관련 스킬