gbro-collage-broll
Turn a 5-second voiceover script, opinion statement, or abstract concept into an editorial halftone paper-collage assemble-from-empty B-roll video. Use when the user requests "collage b-roll", "paper collage B-roll", "halftone collage", "collage video", "gbro-collage-broll", or asks to convert voiceover lines into animated editorial collage visual metaphors. Enforces a 3-gate approval workflow (metaphor confirmation -> still frame confirmation -> video generation via Gemini Omni Flash).
How do I install this agent skill?
npx skills add https://github.com/akillness/jeo-skills --skill gbro-collage-brollIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a specialized workflow for generating halftone paper-collage B-roll videos using Gemini models. It implements a mandatory three-stage human approval process (Metaphor, Still Frame, and Video Generation) to ensure content quality and manage API costs. The included scripts manage environment validation, file uploads via the Gemini Files API, and video generation using the google-genai SDK and ffmpeg. Security analysis shows the skill follows best practices for tool usage and environment management.
- Socketwarn
1 alert: gptAnomaly
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
gbro Collage B-roll
把一句约 5 秒的口播压成一个 sharp visual idea,再做成高级编辑风纸拼贴组装动画。
When to use this skill
Use this skill whenever:
- User asks for "collage b-roll", "paper collage B-roll", "halftone collage", "纸拼贴 b-roll", "半调拼贴", or "gbro-collage-broll".
- Converting voiceover lines or abstract concepts into editorial halftone paper-collage visual metaphors.
- Generating assemble-from-empty 9:16 vertical video clips via Gemini Omni Flash with strict 3-gate human approval.
When NOT to use this skill:
- User requires frame-by-frame exact layer manipulation, timeline editing, or transparent assets (use HyperFrames / HTML-based video renderers instead).
- User only wants video prompts without rendering final MP4 clips.
- User requests realistic human or product photoreal commercial footage.
Instructions
1. Prerequisites & Environment Check
Before Gate 1, run the setup validator script:
bash .agent-skills/gbro-collage-broll/scripts/check_setup.sh
Ensure GEMINI_API_KEY, ffmpeg/ffprobe, Python >= 3.10, and google-genai >= 2.10.0 (in ~/hyperframes-projects/.omni-venv) are ready.
2. 3-Gate Approval Workflow
Gate 1: Visual Metaphor Approval
- Compress the ~5s script into one clear visual thesis (core meaning, emotion, action verb, 3–6 key objects, background/accent colors, assembly sequence).
- Output the metaphor proposal without generating images/videos, then STOP and await user approval.
Gate 2: Still Frame Approval
- After Gate 1 approval, write
visual-spec.jsonand generate the 9:16 still frame via Codeximage_gen. - Generate contact sheet
still-contact-sheet.jpgand writegate2-qa.md. STOP and await user approval before calling any video model.
Gate 3: Video Generation & QA
- After Gate 2 approval, prepare empty color first frame (
first-frame.png) and target last frame (last-frame.png). - Execute batch Gemini Omni Flash video generation using
scripts/generate_video.py(defaulting togemini-omni-flash-preview):
~/hyperframes-projects/.omni-venv/bin/python \
.agent-skills/gbro-collage-broll/scripts/generate_video.py \
--batch <project>/omni-jobs.json \
--concurrency 3
- Convert output MP4 to silent format (
final-5s-noaudio.mp4), run frame extraction contact sheets, and writegate3-qa.md.
Examples
Example 1: Single Line B-roll Request
Input:
collage b-roll: 很多人以为 AI 是来替你思考的,其实它更像一面镜子,会把你问题里的漏洞照出来。
Workflow:
- Gate 1 proposal:
- 核心意思: AI 是照出漏洞的镜子而非替代思考
- 隐喻: 放大镜与撕纸镜面透出光芒照亮排版漏字
- 色彩: 芥末黄底,黑白半调,深红点色
- Gate 2 generation & contact sheet review.
- Gate 3 Omni Flash video generation & silent MP4 delivery.
Best practices
- Strict 3-Gate Discipline: Never skip Gate 1 or Gate 2. Stopping for human approval saves API cost and aligns aesthetic direction before running video models.
- Color Palette Diversity: Do not default all clips to cobalt blue. Use orange, mustard yellow, dark purple, teal, or forest green based on semantics.
- Assemble-from-Empty Timing: Ensure Image 1 is an empty color field and Image 2 is the exact completed frame so Omni Flash performs crisp stop-motion assemble animation.
- No Text/UI Clutter: Keep still frames clean from readable letters, logos, watermarks, or UI artifacts.
References
- Project repo: https://github.com/pyang5166/gbro-collage-broll
- Default Video Model:
gemini-omni-flash-preview
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/akillness/jeo-skills/gbro-collage-broll">View gbro-collage-broll on skillZs</a>