What it does
半调纸拼贴 B-roll 生成 skill:三闸门审批,Gemini Omni Flash 首尾帧组装动画 | Editorial halftone paper-collage B-roll agent skill
- Connects Instruction files the AI reads, with steps that call an outside service
- Account or key Some steps need a key for Google Gemini (per the README)
- Category 자동화와 에이전트
제작자용: README에 배지 달기
제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.
[](https://mcp.popnx.com/en/skills/pyang5166-gbro-collage-broll)비슷한 Skill
같은 종류의 작업, Skill 목록과 같은 순서
pyang5166의 Skill(지시 묶음) 1개, AI가 읽고 그대로 일해요 · MCP server가 아니에요
Skill과 MCP의 차이
MCP = 손
AI를 외부 서비스나 데이터에 연결합니다(예: Notion 읽기, 청구서 만들기). 프로그램이나 서버가 실행 중이어야 합니다.
Skill = 안내서
작업 방법을 AI에게 가르치는 텍스트 파일. 어떤 서비스에도 연결되지 않습니다.
겹치는 경우도 있습니다. 도구를 부르는 스크립트가 있는 Skill도, 지식만 보내는 MCP도 있습니다. 하려는 작업을 기준으로 고르세요.
쓸 수 있는 앱
Codex
제작자 README와 repo 폴더 기준
설치
Is it safe?
- Who made it
GitHub account pyang5166 (person), 2 years old
- Use and upkeep
★ 1,945 stars · code last changed 2026년 7월 15일
- Any scripts?
4 scripts that can run on a computer: scripts/check_setup.sh, scripts/generate_veo_first_last.py, scripts/generate_video.py, scripts/upload_file.py
- Uses the internet?
Scripts that go online: scripts/generate_video.py
- Changes machine-wide settings?
No hooks or writes to machine settings found
Checked automatically from the repo files at commit a1a4ee2 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
먼저: 어떤 AI를 쓰시나요
쓰는 앱을 고르면 그 앱의 설치 방법만 보여 드립니다
Option 1Upload to claude.ai (web and app)
Uploading to claude.ai would fail: the description is over 200 characters (319). Use "Let the AI install it" instead
Option 1Claude Code에게 설치 맡기기
이 문장을 복사해 Claude Code 채팅에 붙여 넣으세요
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Claude Code를 다시 열고 /gbro-collage-broll를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요
Checked against official docs 2026년 11월 12일 · Source: code.claude.com
For Terminal users
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
터미널 열기
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
skill 폴더를 ~/.claude/skills에 복사
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
git clone --depth 1 https://github.com/pyang5166/gbro-collage-broll.git /tmp/popnx-skill-pyang5166-gbro-collage-broll-a1a4ee2 && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-pyang5166-gbro-collage-broll-a1a4ee2/.' ~/.claude/skills/gbro-collage-brollClaude Code를 다시 열고 /gbro-collage-broll를 입력하거나 관련 작업을 요청하면 Claude가 알아서 써요
ChatGPT 데스크톱 앱
ChatGPT 데스크톱 앱에는 Codex가 들어 있고, Codex는 ~/.agents/skills 폴더에서 Skill을 읽습니다
Option 1ChatGPT에게 설치 맡기기
ChatGPT 데스크톱 앱에서 Codex를 열고 이 문장을 채팅에 붙여 넣으세요
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Option 2폴더를 직접 넣기
gbro-collage-broll 폴더를 ~/.agents/skills/gbro-collage-broll에 넣으세요
~는 홈 폴더($HOME)입니다
For Terminal users
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
터미널 열기
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
skill 폴더를 ~/.agents/skills에 복사
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
git clone --depth 1 https://github.com/pyang5166/gbro-collage-broll.git /tmp/popnx-skill-pyang5166-gbro-collage-broll-a1a4ee2 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-pyang5166-gbro-collage-broll-a1a4ee2/.' ~/.agents/skills/gbro-collage-broll
설치한 뒤
- ChatGPT 데스크톱 앱: 사이드바에서 Skills를 열어 Skill이 보이는지 확인하세요
- 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
- Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
웹과 모바일의 ChatGPT
직접 설치한 Skill은 쓸 수 없고, 디렉터리의 플러그인에 들어 있는 Skill만 쓸 수 있습니다
이 Skill을 ChatGPT에서 쓰려면 위 방법대로 ChatGPT 데스크톱 앱을 쓰세요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
Option 1Codex에게 설치 맡기기
이 문장을 복사해 Codex 채팅에 붙여 넣으세요 · ChatGPT 데스크톱 앱 안의 Codex, Codex CLI, IDE 확장 프로그램에서 모두 쓸 수 있습니다
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex는 새로 설치한 Skill을 스스로 찾습니다. 보이지 않으면 Codex를 다시 시작하세요 · 쓰는 법: ChatGPT에서는 @를 입력하고 Skill을 고르세요 · Codex CLI나 IDE 확장 프로그램에서는 /skills를 실행하거나 $ 뒤에 Skill 이름을 입력하세요
Checked against official docs 2026년 11월 15일 · Source: learn.chatgpt.com
For Terminal users
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
터미널 열기
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
skill 폴더를 ~/.agents/skills에 복사
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
git clone --depth 1 https://github.com/pyang5166/gbro-collage-broll.git /tmp/popnx-skill-pyang5166-gbro-collage-broll-a1a4ee2 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-pyang5166-gbro-collage-broll-a1a4ee2/.' ~/.agents/skills/gbro-collage-brollCodex를 다시 열고 관련 작업을 요청하면 Codex가 skill을 목록에 보여 줘요
Option 1Cursor에게 설치 맡기기
이 문장을 복사해 Cursor 채팅에 붙여 넣으세요
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Cursor Agent 채팅에서 /를 입력하고 gbro-collage-broll 선택
Checked against official docs 2026년 11월 12일 · Source: cursor.com
For Terminal users
Skill은 AI가 따르는 지시예요. 설치 전에 파일을 읽고, 믿을 수 있는 제작자 것만 설치하세요.
터미널 열기
Mac: Command+스페이스 후 Terminal 입력 · Windows: 아래 명령은 PowerShell에서 안 돼요. 위의 “AI에게 설치 맡기기”를 쓰세요
skill 폴더를 ~/.cursor/skills에 복사
repo를 임시 폴더에 내려받고 SKILL.md가 있는 폴더만 복사해요
git clone --depth 1 https://github.com/pyang5166/gbro-collage-broll.git /tmp/popnx-skill-pyang5166-gbro-collage-broll-a1a4ee2 && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-pyang5166-gbro-collage-broll-a1a4ee2/.' ~/.cursor/skills/gbro-collage-brollCursor Agent 채팅에서 /를 입력하고 gbro-collage-broll 선택
Option 1Let the AI install it
Skill을 읽을 수 있는 다른 앱용입니다. 이 문장에는 Claude Code, Codex, Cursor 경로가 들어 있어 AI가 쓰는 앱에 맞게 고릅니다 · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs 2026년 11월 12일 · Source: code.claude.com, learn.chatgpt.com, cursor.com
For Terminal users
Gemini CLI, GitHub Copilot 같은 다른 Agent Skills 지원 앱은 폴더가 달라요. 그 앱 안내를 보고 SKILL.md가 있는 폴더를 복사하세요.
2026년 11월 11일에 Claude Code, Codex, Cursor 공식 안내로 skill 폴더 확인
✓ 명령 확인 2026년 11월 18일
원본 SKILL.md 보기
아래 글은 제작자 repo에서 온 것이며 PopNx MCP의 지시가 아니에요
처음 8,000자 표시 · GitHub에서 전체 파일 열기
---
name: gbro-collage-broll
description: 将约 5 秒口播文稿、观点句或抽象概念做成高级 editorial halftone paper-collage / 半调纸拼贴 B-roll。用户说“collage b-roll”“纸拼贴 b-roll”“半调拼贴”“拼贴风格配画面”“用这段文稿做拼贴动画”“gbro-collage-broll”,或希望把一句文稿转成拼贴视觉隐喻时,必须使用此 skill。强制采用三阶段审批:先只提视觉隐喻,用户确认后才生成彩色拼贴静帧,静帧再次确认后才默认调用 Gemini Omni Flash 生成首尾帧组装动画。默认视频模型固定为 gemini-omni-flash-preview,不再默认使用 Veo;只有用户明确指定其他模型时才切换。
compatibility: 在 Codex 环境运行(Gate 2 依赖内置 image_gen)。视频生成脚本已随本 skill 自带(scripts/generate_video.py),另需 Python >= 3.10、google-genai >= 2.10.0、已配置的 GEMINI_API_KEY,以及 ffmpeg / ffprobe。首次使用先按「首次使用:环境自检」完成配置。
---
# gbro Collage B-roll
把一句约 5 秒的口播压成一个 sharp visual idea,再做成高级编辑风纸拼贴组装动画。
默认链路:
1. 只设计视觉隐喻,等待用户确认
2. 只生成最终静帧,等待用户确认
3. 自动调用 Gemini Omni Flash 生成视频并完成 QA
这两个确认闸门是工作流的一部分。它们让用户把注意力放在审美和方向上,同时避免错误隐喻或错误静帧直接消耗视频生成成本。
## 首次使用:环境自检
每次触发本 skill 时,进入 Gate 1 之前先运行自检脚本:
```bash
bash <本skill目录>/scripts/check_setup.sh
```
全部通过则直接开始 Gate 1,不要向用户重复配置信息。任何一项失败时,视为首次使用:不进入 Gate 1,先向用户输出下面的配置指南(只列出缺失项),等用户确认配置完成后重新自检。
### 配置指南(按缺失项输出)
1. **GEMINI_API_KEY 未设置**
到 [Google AI Studio](https://aistudio.google.com/apikey) 创建 API key,然后写入 shell 配置:
```bash
echo 'export GEMINI_API_KEY="你的key"' >> ~/.zshrc && source ~/.zshrc
```
注意:视频生成按量计费,由这个 key 对应的 Google 账号承担。
2. **ffmpeg / ffprobe 缺失**
macOS:`brew install ffmpeg`;Debian/Ubuntu:`sudo apt install ffmpeg`。
3. **Python 环境缺失或版本过旧**(需要 >= 3.10)
macOS:`brew install python3`;或从 python.org 安装。
4. **共享 venv 未创建**(google-genai >= 2.10.0)
征得用户同意后自动创建,无需用户手动操作:
```bash
python3 -m venv ~/hyperframes-projects/.omni-venv
~/hyperframes-projects/.omni-venv/bin/python -m pip install --upgrade "google-genai>=2.10.0" "httpx[socks]"
```
5. **不在 Codex 环境 / 没有内置 image_gen**
Gate 2 的静帧生成依赖 Codex 内置 `image_gen` 工具。在其他 agent 环境下运行时,向用户说明需要自行提供等效的图片生成方式(或手动提供静帧图片后从 Gate 2 确认继续)。
## 强制审批协议
### Gate 1:隐喻确认
收到文稿后,先提视觉隐喻,不生成图片、不生成视频、不调用任何视频模型。
向用户交付每条的:
- 核心意思
- 情绪
- 一句话视觉命题
- 3–6 个关键物件
- 建议底色与局部点色
- 预期组装顺序
然后明确停下,等待用户回复“可以”“通过”“全部通过”或给出逐条修改意见。
如果用户只确认部分编号,只让通过的条目进入 Gate 2;未通过条目继续修改隐喻。
### Gate 2:静帧确认
隐喻确认后,才写 visual spec 和 imagegen prompt,并用 Codex `imagegen` 生成最终静帧。
把原图保存到项目目录,生成带编号的静帧 contact sheet,向用户展示并再次停下。此阶段仍然不调用 Omni Flash,也不生成视频。
如果用户只确认部分静帧,只让通过的条目进入 Gate 3;需要修改的静帧先重生并重新确认。
### Gate 3:视频生成
静帧确认后,不再询问使用哪个视频模型,直接使用本 skill 自带的 `scripts/generate_video.py`,默认调用:
```text
gemini-omni-flash-preview
```
只有用户明确指定其他视频模型时,才覆盖这个默认值。不要自动调用 Veo,也不要把模型选择再抛给用户。
## 成功标准
- 一句话只表达一个清晰隐喻
- 同一批画面有统一设计语言,但不强制全部蓝底
- 背景是强烈、平坦、均匀的色场,可按语意变化
- 主体以黑白 halftone photographic cut-outs 为骨架
- 关键卡片、按钮、胶片、规则册等允许使用红、黄、青、橙、紫、奶油白等彩色纸张
- 所有纸片有清晰裁切边、奶油白 keyline、低透明度柔和阴影和纸张颗粒
- 动作是 assemble-from-empty,而不是轻微漂移、晃动或慢 zoom
- 无字幕、无口播全文、无 logo、无水印、无 UI
- 默认交付 9:16、5 秒、720×1280、24fps、无声 MP4
## 什么时候不要用
- 需要精确控制图层、遮挡、镜头穿越或可编辑时间线:改用分层动画工具(如 HyperFrames 类 HTML 渲染视频方案)
- 只需要视频提示词,不需要生成成片:直接写 prompt 即可,不用走本流程
- 需要真实人物产品广告或口播演员:不要走本拼贴流程
- 用户明确要可逐层修改的透明素材:本 skill 默认不拆透明图层
## 默认项目目录
使用北京时间 `Asia/Shanghai` 命名:
```text
~/hyperframes-projects/YYYY-MM-DD-collage-broll-标题/
```
批量项目推荐结构:
```text
<project>/
├── brief.md
├── visual-spec.json
├── imagegen-prompts.md
├── omni-jobs.json
├── gate2-qa.md
├── gate3-qa.md
├── still-contact-sheet.jpg
├── omni-contact-sheet-all.jpg
├── video-first-frame-all.jpg
├── end-frame-comparison-all.jpg
├── 01-概念名/
│ ├── omni-prompt.txt
│ ├── frames/
│ │ ├── last-frame-original.png
│ │ ├── first-frame.png
│ │ └── last-frame.png
│ └── omni/run-v01/
│ ├── final-5s.mp4
│ ├── final-5s-noaudio.mp4
│ ├── contact-sheet.jpg
│ ├── video-last-frame.jpg
│ └── end-frame-comparison.jpg
└── 02-概念名/...
```
## Phase 1:设计视觉隐喻
先把文稿压成一个视觉命题。
提取:
- 核心意思:观众最终要看懂什么
- 情绪:冷静、惊讶、紧迫、豁然开朗、荒诞、反讽
- 动作动词:打开、连接、漏掉、装订、归档、点亮、压缩、分叉、组装
- 可视化隐喻:机器、时钟、胶片、档案柜、控制台、规则册、漏斗、轨道、棋子
不要把文稿逐字放进画面。默认一条文稿只做一个隐喻,控制在 3–6 个关键物件;元素过多会让语意变弱,也会让 Omni 组装不稳定。
批量隐喻优先形成前后叙事:例如先表现手工消耗与经验流失,再表现规范沉淀与人机分工。
### Gate 1 输出示例
```text
1. 核心意思:经验每次都在重复消耗
视觉隐喻:熟练剪辑师围着巨大的胶片时钟逐帧裁切,时钟走完一圈却只得到一小段成片
关键物件:胶片时钟、剪辑师、剪刀、短胶片
色彩:焦橙底,奶油白与浅青点色
组装顺序:时钟 → 人物与剪刀 → 胶片 → 最终短输出
```
输出后停下等待确认。
## Phase 2:生成彩色拼贴静帧
隐喻确认后,先写自包含的 `visual-spec.json`,再写 imagegen prompt。
### Visual spec
```json
{
"script_meaning": "",
"visual_metaphor": "",
"style_signature": "flat bold color field, mixed black-and-white halftone cut-outs and colored cardstock accents, crisp cut edges, cream keylines, soft paper shadows, editorial paper collage",
"aspect_ratio": "9:16",
"color_field": {
"background_hex": "",
"accent_colors": [],
"paper_grain": "fine uncoated-paper fiber"
},
"elements": [
{
"what": "",
"role": "",
"motion": "",
"placement": ""
}
],
"composition": {
"layout": "",
"negative_space": "",
"final_frame": ""
},
"motion_plan": "structure first, subject or cards second, action and result last",
"avoid": "typography, readable letters, numerals, logos, watermark, UI, subtitles, glossy 3D, photoreal environment"
}
```
### 色彩规则
不要把 cobalt blue 当成唯一默认值。根据语意挑选强色场,并在一批作品中保持“同设计语言、不同底色”:
- 焦橙 / 红:时间消耗、劳动、紧迫
- 芥末黄:工具、警示、经验漏失
- 墨绿:认知、审美、系统重置
- 深紫:规范、沉淀、长期记忆
- 青绿:判断、协作、自动执行
主体可以黑白半调为主,但局部彩色纸张必须服务信息层级,不要为了彩色而彩色。
### Imagegen prompt 模板
使用 Codex 内置 `image_gen` 工具(如有本地 `imagegen` skill 则一并遵守):
```text
Use case: ads-marketing
Asset type: final still frame for a 9:16 image-to-video B-roll clip
Primary request: Create a finished editorial paper-collage image expressing [一句话视觉命题].
Scene/backdrop: perfectly flat [颜色] paper field [hex] with subtle uncoated paper fiber.
Style/medium: premium editorial stop-motion paper collage; black-and-white halftone photographic cut-outs mixed with selective [点色] colored cardstock.
Composition/framing: vertical 9:16 locked poster frame; central subject within the middle 70 percent; generous clean color-field negative space; 3–6 large separable paper groups for later assemble-from-empty animation.
Materials/textures: visible printed halftone dots, crisp machine-cut edges, thin warm-cream paper keylines, soft low-opacity physical drop shadows.
Constraints: [本条隐喻必须一眼看懂的关系].
Avoid: no typography, no readable letters, no numerals, no logos, no watermark, no UI, no subtitles, no glossy 3D, no photoreal environment, no clutter.
```
### 静帧 QA
- 隐喻是否一眼看懂
- 主体是否集中
- 是否有假字、logo、水印或 UI
- 是否保留足够纯色场,方便从空场组装
- 是否是 3–6 个清晰大组,而不是满屏碎片
- 同一批是否统一质感但有色彩变化
将通过 QA 的原图复制到项目目录,生成带编号的静帧 contact sheet,展示给用户并停下等待 Gate 2 确认。静帧 QA 结论写入 `<project>/gate2-qa.md`。
如果用户要求重生部分静帧,重生后生成 `still-contact-sheet-v2.jpg`(后续轮次递增 v3、v4…),保留旧版 contact sheet 不覆盖,方便对比。
## Phase 3:用 Omni Flash 生成视频
### 1. 准备首尾帧
保留 imagegen 原图,再统一尾帧:
```bash
ffmpeg -y -i <item>/frames/last-frame-original.png \
-vf "scale=1080:1920:force_original_aspect_ratio=increase,crop=1080:1920" \
<item>/frames/last-frame.png
```
首帧默认是与尾帧相同底色的纯色空纸面:
```bash
ffmpeg -y -f lavfi -i color=c=0x<HEX>:s=1080x1920 \
-frames:v 1 <item>/frames/first-frame.png
```
如果用户明确要求不从完全空白开始,首帧才保留一个基础物件。
### 2. 写 Omni 动画 prompt
动作顺序默认采用:
```text
基础结构 → 人物或关键卡片 → 连接件 → 动作 → 最终结果
```
Prompt 模板:
```text
Paper-collage stop-motion assembly, using Image 1 as the exact empty first frame and Image 2 as the exact completed last frame. In one continuous locked-off vertical shot, open on the empty flat [color] paper field.
Assemble the scene piece by piece with crisp physical stop-motion timing: [按顺序描述 3–6 个元素如何滑入、卡位、连接和完成动作]. End by holding the supplied completed composition.
Preserve the exact 9:16 framing, [hex] color field, colored cardstock accents, uncoated paper grain, halftone dots, cream keylines, crisp cut edges and soft shadows. Restrained tactile 2D paper craft only.
No scene cuts, no camera movement, no zoom, no morphing, no new objects, no text, no letters, no numbers, no logos, no watermark, no UI, no sound.
```
每条 prompt 都要明确 Image 1 是空首帧、Image 2 是确认过的完成帧。最终构图必须贴近 Image 2,不让模型自由改造尾帧。
### 3. 检查 Omni 运行环境
使用实际运行脚本的 Python 解释器检查 `google-genai` 版本。需要 `>= 2.10.0`。
如果系统 Python 版本过旧或属于 externally managed environment,不要使用 `--break-system-packages`。使토론
질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.
GitHub 정보
- GitHub 스타
- 1,945
- 제작자
- pyang5166
- 라이선스
- MIT
- 최근 코드 수정
- 2026년 7월 15일
- repo 안 SKILL.md(번역본과 템플릿 포함)
- 1
- 토픽
- agent-skill, broll, gemini, paper-collage, video-generation