Coleta, revisão em Storyboard e entrega segura de B-rolls para macOS e Windows.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
# Add to your Claude Code skills
git clone https://github.com/engenheirodevideo/get-brollsGuides for using ide extensions skills like get-brolls.
Você planeja fontes literais, mostra o trecho à pessoa, recebe a decisão dela e só então entrega o corte. Fale português direto, sem jargão de CLI, e nunca transforme a conversa num formulário.
Literal primeiro. Procure o fato, a pessoa, o produto, a notícia ou a tela que a narração cita. Banco genérico não cobre beat sem fonte literal.
Stock só sob pedido. Pexels e Pixabay entram quando o usuário pedir stock com todas as letras. Nunca como preenchimento.
Parada obrigatória na revisão. Aprovação vem sempre de uma pessoa: pelo Storyboard (import-review) ou por fala explícita no chat, registrada com approve --candidate <ID> --by NOME --channel chat --statement "frase". Silêncio não é aprovação. Não se autoaprove.
Sem BRIEF.md na pasta do projeto, conduza a entrevista de /get-brolls-brief. O roteiro está em references/interview.md: sete perguntas, uma por mensagem, teto de sete — pare assim que 1, 3 e 7 estiverem respondidas. Dois "tanto faz" viram defaults, com o que foi assumido visível na resposta. Nunca invente narração, alvo, link ou responsável.
Rode o CLI pelo caminho absoluto da instalação da skill: os exemplos escrevem scripts/gb.py por brevidade. --project é sempre a pasta do usuário, também absoluta, e vai em todo comando.
Escreva o BRIEF.md com python3 "scripts/gb.py" init-brief --project <projeto>, preencha o bloco JSON e valide com brief --validate. Se a pessoa nomeou a plataforma (Reel, Shorts, horizontal), alinhe o video_format do RULES.md antes de validar: init-rules --format reels --force --project <projeto>.
Checkpoint C1. Em até cinco linhas: o que o vídeo precisa provar, quantos beats, as fontes na ordem, o que ficou por default e quem assina. Feche com "fecho assim?" e espere.
python3 "scripts/gb.py" brief --beat <ID> --project <projeto> devolve o comando pronto do beat. Todo material entra com --shot <beat.id>. Consulte library --search "termo" antes: ela lembra o que rendeu, sem aprovar nem permitir. Fontes, presets, lotes e a biblioteca estão em references/providers.md. Reel do Instagram: leia references/instagram.md antes de tocar no navegador — é a rota que quebra primeiro.
Checkpoint C2. Liste 5 a 8 candidatos, uma linha cada: título, canal, duração e a janela do inspect. Feche com "sigo com estes?".
python3 "scripts/gb.py" inspect --candidate <ID> --query "fala ou alvo" --project <projeto> lê duração, capítulos e legendas e devolve janelas pontuadas; escreva a --query no idioma da fonte. Escolha --start/--end a partir delas, nunca de palpite.
Depois, python3 "scripts/gb.py" preview --candidate <ID> --start <INICIO> --end <FIM> --project <projeto> gera poster, contact sheet e GIF: até 10 s por prévia (GB_PREVIEW_MAX_SECONDS) e um preview por chamada, senão a chamada estoura o tempo. A resposta traz files.contact_sheet (no status e no manifesto, preview.contact_sheet_path, relativo a brolls/) e preview.frame_times_s. Abra e olhe antes de seguir. Cite em --reason as células e os tempos que viu; se não servirem, ajuste o intervalo. Nunca descreva quadro que não conferiu.
Sem pista, preview --scan varre o vídeo inteiro: exploratório, depois de inspect, e ignora o intervalo escolhido.
Duas rotas, e você para nas duas.
Board, quando quem revisa é outra pessoa: python3 "scripts/gb.py" review --project <projeto>, depois serve --background --project <projeto>. Entregue a URL, peça a decisão e importe com import-review --by NOME --project <projeto> — sem --file, ele pega o arquivo mais recente da página.
Antes do C3, rejeite o que descartou: reject --candidate ID1 --candidate ID2 … --reason "por quê" --project <projeto>. Assim o status reflete a conversa.
Chat, quando a pessoa está aqui. Checkpoint C3: descreva o que cada contact sheet mostra e pergunte "aprova todos, ou quais?". Aprove exatamente os IDs que você mostrou: approve --candidate ID1 --candidate ID2 … --by NOME --channel chat --statement "frase exata" --project <projeto>; use --all só quando todos os candidatos com prévia foram mostrados. No canal chat, --statement é obrigatório.
Mudança de intervalo ou de contexto invalida aprovação. A copy pronta das duas rotas está em references/templates-de-resposta.md.
Registre as condições com permit (--evidence, --preset ou --declared-by/--declaration-text), depois fetch, verify e deliver. As três rotas estão em references/rights.md. Não invente licença. deliver monta entrega/, uma pasta por beat, com ORIGEM.md.
python3 "scripts/gb.py" status --project <projeto> diz onde a coleta está sem alterar nada. Ao responder, repasse summary.do.for_human sem parafrasear: é a frase que já traz o próximo passo na língua da pessoa.
Diga o que tentou e o motivo real. Pergunte se a pessoa tem material próprio ou um link. Não invente indisponibilidade permanente nem troque de arquitetura sozinho.
python3 "scripts/gb.py" doctor diz o que está pronto e o que falta. No Windows, use python no lugar de python3. Faltando algo, peça /get-brolls-setup. Versão diferente da deste arquivo: leia o CHANGELOG.
references/interview.md — as sete perguntas do brief.references/providers.md — fontes, ordem, biblioteca e lotes.references/instagram.md — o procedimento dos dois streams.references/rights.md — condições de uso e permit.references/templates-de-resposta.md — copy pronta.references/glossario.md — o que cada termo quer dizer.docs/GUIDE.md — detalhe técnico por provedor.See how get-brolls compares with popular alternatives.
Get B-rolls é uma skill para coletar os vídeos e imagens que apoiam uma fala, ilustram uma ideia ou mostram exatamente a pessoa, o produto e o acontecimento citados no roteiro. Você descreve o que precisa; o agente pesquisa, prepara as prévias e reúne as escolhas em um storyboard para sua revisão.
O agente procura a fonte literal do que você cita: o fato, a pessoa, o produto, a notícia ou a tela reais. Bancos de vídeo entram somente quando você pedir stock explicitamente. Um único insert funciona sem roteiro completo: basta explicar o que precisa aparecer.
A prévia pode baixar mídia de trabalho para mostrar o movimento. A entrega final depende da decisão humana e do registro das condições de uso da fonte. Se o intervalo ou o contexto mudar, o trecho volta para revisão.
brolls/getbrolls.log (GB_LOG_LEVEL, GB_LOG_STDERR): comandos, trilha de aprovação, subprocessos e rede, sem nomes, frases de aprovação nem URLs. reject zera o output, verify confere todos os clipes e desmarca o que foi alterado, e deliver pula clipe rejeitado ou reprovado e lista em skipped. Storyboard local endurecido (só review.html, previews/ e clips/, cabeçalhos contra embutir a página). ~/.getbrolls/RULES.md ilegível passa a parar o comando em vez de ser ignorado.scripts/preflight.sh), versão escrita numa passada (scripts/bump_version.py) e espelho do SKILL.md gerado (scripts/gen_skill_mirror.py). GB_CACHE_DIR passa a valer no .env; GETBROLLS_CACHE_DIR continua funcionando. Sem mudança no fluxo de coleta.description ganha aspas; o GitHub não renderizava o arquivo).BRIEF.md por projeto (init-brief/brief), aprovação pelo chat (approve --all --by NOME --channel chat --statement "..."), biblioteca de aprendizados entre projetos (learn/library), análise da fonte antes de coletar (inspect, preview --scan), pasta entrega/ por beat (deliver), Storyboard que salva as decisões dentro do projeto, próximo passo pronto em status.summary.do, search --shot/--dry-run e init-rules --format.queue), instagram_pairs --pace/--max-per-run/--continue-on-error, pausas do yt-dlp e respeito a Retry-After, erros legíveis com stderr redigido, cache por intervalo/NASA/drawtext, e comando serve para o Storyboard local.status --project ("onde estamos?"), CLI autoexplicativa com --version, comando de plugin /get-brolls-setup, quickstart "Primeiro B-roll em 5 minutos", caminhos de ferramentas fixáveis via GB_*_PATH e AGENTS.md como hub do repositório.Histórico completo no CHANGELOG.md.
A skill só funciona completa com todas as ferramentas abaixo instaladas antes do passo 2. Sem uma delas, a coleta roda parcialmente e o Storyboard sai sem prévia ou sem contact sheet numerado.
| Ferramenta | Para quê | Sem ela |
|---|---|---|
| Python 3.11+ | CLI, ledger, coleta do Instagram | nada roda |
FFmpeg + ffprobe com libfreetype (drawtext) |
poster, contact sheet numerado, GIF, cortes | sem prévia; sem drawtext, o sheet sai sem número/timecode e o Storyboard mostra só a legenda |
| Node 22+ com npm/npx | Playwright CLI e runtime EJS do yt-dlp | YouTube e Instagram falham |
| curl | download dos pares de stream do Instagram | Instagram falha |
| Git | clonar e atualizar | instalação manual |
| yt-dlp e Playwright CLI | instalados pelo install.sh/install.ps1 no passo 2 |
YouTube/TikTok e Instagram falham |
macOS (Homebrew):
brew install python ffmpeg node git curl
Windows (winget, PowerShell 5.1 já serve):
winget install Python.Python.3.13 Gyan.FFmpeg OpenJS.NodeJS.LTS Git.Git
Ubuntu/Debian:
sudo apt install python3 python3-venv ffmpeg nodejs npm curl git
Depois do passo 2, python3 scripts/gb.py doctor é o gate: summary.missing vazio e contact_sheet.labels: true. Se aparecer drawtext em summary.optional, seu FFmpeg veio sem libfreetype: reinstale pelo comando acima (no macOS, brew reinstall ffmpeg).
No Claude Code, você também pode instalar a skill como plugin, sem clonar manualmente:
/plugin marketplace add engenheirodevideo/get-brolls
/plugin install get-brolls@engenheirodevideo
git clone https://github.com/engenheirodevideo/get-brolls.git
cd get-brolls
| Agente | Instalação pessoal | Dentro de um projeto | Como chamar |
|---|---|---|---|
| Codex | ~/.agents/skills/get-brolls/ |
.agents/skills/get-brolls/ |
$get-brolls |
| Claude Code | ~/.claude/skills/get-brolls/ |
.claude/skills/get-brolls/ |
/get-brolls |
Ao copiar uma pasta de desenvolvimento, exclua .venv/, .tools/, caches, projetos e arquivos privados. skills/ e .claude-plugin/ são artefatos do plugin do Claude Code e podem ser omitidos ao copiar para o Codex. Instale as dependências no destino final e abra uma nova sessão do agente. Veja instalação, atualização e compatibilidade.
Na pasta instalada da skill, use o instalador do seu sistema.
macOS:
bash scripts/install.sh --check
bash scripts/install.sh
python3 scripts/gb.py doctor
Windows PowerShell:
powershell -ExecutionPolicy Bypass -File scripts/install.ps1 -Check
powershell -ExecutionPolicy Bypass -File scripts/install.ps1
python scripts/gb.py doctor
O instalador cria os ambientes locais e obtém as versões registradas de yt-dlp/EJS e Playwright CLI. --check só valida pré-requisitos (Python, FFmpeg/ffprobe, Node, curl, Git) e não instala nada; rode-o antes do instalador completo para saber o que falta. doctor confere a disponibilidade das ferramentas depois de instaladas; o acesso a cada fonte depende da URL e, quando necessário, da sua sessão de navegador.
Quer cada comando explicado, passo a passo? Veja o manual + tutorial.
A sequência mais curta pelo terminal, usando uma fonte sem chave (NASA). Troque /caminho/meu-video pelo seu projeto e <ID> pelo identificador devolvido pela busca — mantenha as aspas, porque identificadores podem conter espaços.
python3 scripts/gb.py search --provider nasa --query "Artemis launch" --limit 3 --intent literal --project /caminho/meu-video
python3 scripts/gb.py preview --candidate "<ID>" --start 0 --end 4 --project /caminho/meu-video
python3 scripts/gb.py review --project /caminho/meu-video
python3 scripts/gb.py serve --background --project /caminho/meu-video
Abra o storyboard local pela URL que o comando devolveu na hora, decida os trechos e exporte o JSON — abrir a página por `fil
get-brolls is an open-source ide extensions skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by engenheirodevideo. Coleta, revisão em Storyboard e entrega segura de B-rolls para macOS e Windows. It has 51 GitHub stars.
get-brolls's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/engenheirodevideo/get-brolls" and add it to your Claude Code skills directory (see the Installation section above). get-brolls ships a SKILL.md manifest, so compatible agents can discover and load it automatically.
get-brolls is primarily written in Python. It is open-source under engenheirodevideo on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other IDE Extensions skills you can browse and compare side by side. Open the IDE Extensions category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh get-brolls against similar tools.
No comments yet. Be the first to share your thoughts!
Top skills in this category by stars