Agent skill for collecting the videos and images that support a line, illustrate an idea, or show the exact person, product, or event mentioned in a script. You describe what you need; the agent researches, prepares previews, and gathers the options into a storyboard for your review.
Claude Code
> /plugin marketplace add engenheirodevideo/get-brolls> /plugin install get-brolls@engenheirodevideo
Codex
$ npx skills add engenheirodevideo/get-brolls -a codex
Cursor
$ npx skills add engenheirodevideo/get-brolls -a cursor
Gemini CLI
$ npx skills add engenheirodevideo/get-brolls -a gemini-cli
GitHub Copilot
$ copilot plugin marketplace add engenheirodevideo/get-brolls$ copilot plugin install get-brolls@engenheirodevideo
OpenCode
$ npx skills add engenheirodevideo/get-brolls -a opencode
Windsurf
$ npx skills add engenheirodevideo/get-brolls -a windsurf
O getbrolls é 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.
ROTEIRO.md revisado por você e sair como projeto de edição por um plugin (experimental).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.
O getbrolls não edita nem renderiza o vídeo. Ele coleta, mostra a prévia e entrega os clipes com origem e condições de uso; quem monta e renderiza é o seu editor ou o HyperFrames.
São oito passos, como num fluxo de edição: ingest, seleção, aprovação do cliente e entrega.
doctor).RULES.md), plano por beat (BRIEF.md) ou o roteiro (ROTEIRO.md).ORIGEM.md ao lado de cada corte.getbrolls. O setup prepara o yt-dlp e o Playwright, e o doctor diz se está pronto.ROTEIRO.md, revisa o texto e os beats de b-roll nascem dele. Só gênero reels, experimental.project.json. O init cria a pasta do vídeo com aroll/, assets/, broll/ e analysis/. Projeto da 2.5 continua igual.analysis dá a cada mídia do projeto um id calculado pelo conteúdo e grava duração, quadro e codecs.resolve --url aceita link .m3u8/.mp4 e página com player de vídeo embutido.capabilities --json descreve comandos e códigos de saída. Erro de operação agora sai com 1.Vindo da 2.5? Veja Atualizar da 2.5 para a 2.6. A lista completa está no CHANGELOG.
A skill só funciona completa com todas as ferramentas abaixo. Sem uma delas, a coleta roda pela metade e o Storyboard sai sem prévia.
| Ferramenta | Para quê | Sem ela |
|---|---|---|
| Python 3.11+ | CLI, registro do projeto, coleta do Instagram | nada roda |
FFmpeg + ffprobe com libfreetype (drawtext) | poster, folha de quadros numerada, GIF, cortes | sem prévia; sem drawtext, a folha sai sem número e timecode |
| 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 em $GB_HOME/runtime pelo setup, no passo 1 | 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 (plataforma secundária):
sudo apt install python3 python3-venv ffmpeg nodejs npm curl git
São três jeitos. Escolha um.
Cole estas duas linhas no Claude Code:
/plugin marketplace add engenheirodevideo/get-brolls
/plugin install get-brolls@engenheirodevideo
Depois peça /get-brolls:get-brolls-setup. Ele instala o runtime em $GB_HOME/runtime e responde em uma linha se está pronto. O agente roda os comandos por você.
uv tool install git+https://github.com/engenheirodevideo/get-brolls@v2.6.2
getbrolls setup
getbrolls doctor
Com o pipx, troque a primeira linha por pipx install git+https://github.com/engenheirodevideo/get-brolls@v2.6.2. Apareceu getbrolls: command not found? Rode uv tool update-shell (ou pipx ensurepath) e abra um terminal novo.
Os exemplos deste README usam o comando getbrolls …. Num clone, sem instalar o pacote, python3 scripts/gb.py … roda os mesmos comandos (no Windows, python scripts/gb.py …; de outra pasta, use o caminho absoluto de scripts/gb.py).
git clone https://github.com/engenheirodevideo/get-brolls.git
cd get-brolls
Copie a pasta para o lugar de skills do seu agente:
| 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 |
| Outros agentes | a pasta de skills do agente | a pasta de skills do projeto, se houver | pelo nome, get-brolls |
Ao copiar, deixe de fora .venv/, .tools/, caches, projetos e arquivos privados. Na pasta final, rode o instalador do seu sistema e confira com o script da própria pasta (o getbrolls do PATH, se houver, pode ser outra instalação).
macOS e Linux:
bash scripts/install.sh --check
bash scripts/install.sh
python3 scripts/gb.py doctor
Windows PowerShell:
powershell -ExecutionPolicy RemoteSigned -File scripts/install.ps1 -Check
powershell -ExecutionPolicy RemoteSigned -File scripts/install.ps1
python scripts/gb.py doctor
O --check só confere os pré-requisitos. O instalador chama o setup, que instala yt-dlp e Playwright CLI em $GB_HOME/runtime, fora da pasta da skill. Uma pasta que veio de um zip pode precisar de Unblock-File -Path scripts\*.ps1 uma vez, feito por você. Fora do Claude Code não existe comando de barra: peça o passo em palavras. Instalação em detalhe.
Está pronto quando o doctor responde ready: true e sai com 0. Faltando algo, ele sai com 4 e lista o que falta em summary.missing, cada item com o comando que resolve.
Com a stack inteira, o doctor também mostra contact_sheet.labels: true. Se aparecer drawtext em summary.optional, o seu FFmpeg veio sem libfreetype: no macOS, brew reinstall ffmpeg.
Usa a NASA, que não pede chave. Rode um por vez, na ordem. Troque /caminho/meu-video pela pasta do seu vídeo e <ID> pelo código que a busca devolver. Mantenha as aspas. Quer cada comando explicado? Veja o manual e tutorial.
getbrolls init --project /caminho/meu-video
getbrolls search --provider nasa --query "Artemis launch" --limit 3 --project /caminho/meu-video
getbrolls preview --candidate "<ID>" --start 0 --end 4 --project /caminho/meu-video
getbrolls review --project /caminho/meu-video
getbrolls serve --background --project /caminho/meu-video
Abra o link que o serve devolveu, clique em Aprovar e depois em Salvar decisões. Abra sempre pelo link: por file:// o salvamento pode não funcionar.
getbrolls import-review --by "Seu nome" --project /caminho/meu-video
getbrolls serve --stop --project /caminho/meu-video
getbrolls permit --candidate "<ID>" --preset nasa --project /caminho/meu-video
getbrolls fetch --candidate "<ID>" --project /caminho/meu-video
getbrolls verify --project /caminho/meu-video
getbrolls deliver --project /caminho/meu-video
Pronto: o corte está em broll/, e a entrega/ tem uma pasta por beat com o ORIGEM.md dizendo de onde ele veio. Sem BRIEF.md, ele cai em entrega/00-sem-beat/. O preset nasa grava os termos padrão da NASA: confira mesmo assim a página do vídeo.
Se você nunca abriu um terminal, esta é a lista inteira. Todos os passos são conversa com o agente.
/get-brolls:get-brolls-setup. Ele instala tudo em $GB_HOME/runtime e responde em uma linha se está pronto. O runtime sobrevive ao /plugin update./get-brolls preciso de vídeos de apoio pro meu Reel sobre X — e diga também em que pasta o projeto vai ficar.Stars on GitHub
A plugin of skills for building videos from HTML with HyperFrames, covering motion design, transitions, captions, cursor effects and changelog videos. Useful for developers and agents who want to render motion graphics and product videos.
@heygen-comAn open-source video production system that turns an AI coding assistant into a video studio, with production pipelines, tools, and skills for generating music, voiceover, avatar videos, AI video clips, and transcripts.
@calesthioSkills for building videos programmatically with React using Remotion. They cover creating new videos, transcribing and animating captions, structuring interactive video, and searching the Remotion documentation.
@remotion-devA toolbox of film styles made in code: 66 ready to use, and your own. Pick a style or make one from scratch, bring your story, and let your coding agent direct. 66 种影片风格，每种都配一支完全用代码做出来的短片 · 中文用户请看 简体中文说明 Built for Claude.
@lemomo-aiAgent skill for collecting the videos and images that support a line, illustrate an idea, or show the exact person, product, or event mentioned in a script. You describe what you need; the agent researches, prepares previews, and gathers the options into a storyboard for your review. Install it with the command on its page. It includes get-brolls. Its skills do not fire on their own yet. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it