Agent skill

Collage B-Roll Video Maker

by imraywang in imraywang/rayskills

Turns a spoken line or a full topic into editorial-collage videos of halftone cut-outs assembled piece by piece, as 5-second B-roll or a narrated explainer.

Custom licenceAuto-check passedMedia & Creative

SKILL.md written in Chinese; this summary is our English description.

Install Collage B-Roll Video Maker

skills CLI
$ npx skills add imraywang/rayskills --skill ray-broll -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install imraywang/rayskills ray-broll --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/imraywang/rayskills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ray-broll .claude/skills/ray-broll && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ray-broll
GitHub stars
160
Token cost
~2.6k tokens
SKILL.md length
666 words
Files
21 (incl. scripts, references)
Skills in repo
12
Repo updated
First seen
Licence
Custom licence

At a glance

Turns a spoken line or a full topic into editorial-collage videos of halftone cut-outs assembled piece by piece, as 5-second B-roll or a narrated explainer.

  • Works in 8 steps: 首尾帧(关键坑:底色用实测值) → Omni 动画 prompt 模板 → 批量调用 → …
  • Making stylized paper-collage B-roll for a spoken line or opinion
  • SKILL.md covers 环境自检, 模型, 成功标准(视觉语法) and 项目目录, plus 8 more sections
  • Runs Python and Shell scripts from its folder; calls python, bash and pip; needs GEMINI_API_KEY and FAL_KEY

What it does

The skill has two modes. One takes a single spoken line, alone or in a batch, and makes a 5-second B-roll clip. The other is driven by a beat map and makes a full explainer of 45 to 60 seconds with TTS narration, content-aware speed changes, subtitles and assembly. The look is black-and-white halftone cut-outs on flat color fields, animated as stop-motion pieces appearing one by one on an empty field. It shares its visual system with a sister cover skill and avoids copying any brand or living artist, translating requests for a named channel's style into describable collage mechanics.

The default chain has three gates in rising order of cost: design the visual metaphor and wait for approval, generate final still frames and wait again, then call a video model for first-frame to last-frame assembly animation and run QA. In batches only approved items move on, and you can authorize a full automatic run, though QA notes are still written. Each run starts with scripts/check_setup.sh. Stills, video and narration all use Gemini models on one GEMINI_API_KEY, billed per use, with video as the main cost, so only failed jobs are re-run and each Gate 3 records a cost line.

Visual rules call for one clear metaphor per line with no more than 4 key objects, a flat background color chosen by meaning, paper pieces with cream outlines, soft shadows and grain, and no subtitles, logos or watermarks. The default delivery is a silent 9:16 MP4 of 5 seconds at 720×1280 and 24fps. The skill is not for precise layer and timeline control, prompt-only requests, live-action talking heads or product shoots.

When your agent uses it

  • Making stylized paper-collage B-roll for a spoken line or opinion
  • Producing a 45 to 60 second narrated explainer from a topic using a beat map
  • Batch-generating short vertical clips with approval gates to control cost

Example prompts

  • “Make a collage B-roll for the line 'meetings eat the week' and show me the metaphor first.”
  • “Turn this topic into a narrated paper-collage explainer and stop at each approval gate.”
  • “Batch five spoken lines into 9:16 collage clips, but only run video on the approved stills.”

Requirements

  • A GEMINI_API_KEY with pay-per-use billing
  • Python and bash for the bundled scripts

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. 首尾帧(关键坑:底色用实测值)
  2. Omni 动画 prompt 模板
  3. 批量调用
  4. 强制无声交付 + QA 产物
  5. Beat map(Gate 1 的完整片版本)
  6. 旁白与变速
  7. 字幕
  8. 拼装

What it can do on your machine

Read from SKILL.md and the folder at commit 2ad2449. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 10 files in scripts/ (Python and Shell, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • python
    • bash
    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GEMINI_API_KEY
    • FAL_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Collage B-Roll Video Maker loads about 2.6k tokens when it runs, and up to ~7k if it reads all its reference files. Until then it costs about 80 tokens; SKILL.md has 666 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~2.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 666 words (~2,641 tokens).

name
ray-broll

Read the full SKILL.md on GitHub

Files

SKILL.md and 20 other files (scripts, references) in skills/ray-broll of imraywang/rayskills.

  • SKILL.md
  • agents/openai.yaml
  • evals/evals.json
  • references/beats-manifest.md
  • references/flow-runbook.md
  • references/narrative-arcs.md
  • references/theme-presets.md
  • scripts/assemble.py
  • scripts/check_setup.sh
  • scripts/fal_driver.py
  • scripts/generate_image.py
  • scripts/generate_tts.py
  • scripts/generate_video.py
  • scripts/overview.py
  • scripts/prepare_frames.sh
  • scripts/qa_score.py
  • scripts/qa_video.sh
  • … and 4 more

Open the folder on GitHubat commit 2ad2449

Compare with similar skills

Collage B-Roll Video Maker next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Collage B-Roll Video Maker compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Collage B-Roll Video Maker this skillimraywang/rayskills160—~2.6kAutomated safety check: PassCustom licence
Super Video MakerBomx/super-video-maker-skill305—~11kAutomated safety check: NotesNone
Editorial Collage MotionPluviobyte/rnskill1.6k—~1.2kAutomated safety check: PassCustom licence
Wjs Converting Text To Videojianshuo/claude-skills130—~5.5kAutomated safety check: NotesMIT
HyperFrames Video Entry Pointheygen-com/hyperframes58k3 repos~5.2kAutomated safety check: PassApache-2.0
Hyperframesboraoztunc/skills3939 repos~7.6kAutomated safety check: PassApache-2.0

Similar skills

  • Super Video Maker

    Bomx/super-video-maker-skill

    End-to-end AI video production skill for agentic frameworks.

    305 GitHub stars~11k tokensUpdated 1 mo ago
    Media & CreativeAuto-check: notes
  • Editorial Collage Motion

    Pluviobyte/rnskill

    将参考图或简要描述解码为可编辑的半色调纸张拼贴规范,默认使用 Codex 内置 imagegen 生成品牌一致的静帧和透明图层,再用本地 FFmpeg 或 HyperFrames 制作“从空背景逐件组装”的确定性动态视频。用户提到半色调拼贴、纸张拼贴、剪纸拼贴、编辑式拼贴、杂志拼贴、复古印刷拼贴、拼贴动效、拼贴动画、剪纸动画、纸片组装、逐层组装、从无到有、元素飞入拼装、定格拼贴、定格动画、Arc…

    1.6k GitHub stars~1.2k tokensUpdated 16 days ago
    Media & CreativeAuto-check passed
  • Wjs Converting Text To Video

    jianshuo/claude-skills

    A skill your agent uses when the user wants a 王建硕-style WeChat article (article.md) turned into a narrated short MP4 video — TTS voiceover via 火山引擎 Volcano TTS, HyperFrames CSS/GSAP animation per…

    130 GitHub stars~5.5k tokensUpdated 1 mo ago
    Media & CreativeAuto-check: notes
  • HyperFrames Video Entry Point

    heygen-com/hyperframes

    Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.

    58k GitHub starsUsed in 3 repos~5.2k tokens
    Media & CreativeAuto-check passed
  • Hyperframes

    boraoztunc/skills

    Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML.

    393 GitHub starsUsed in 9 repos~7.6k tokens
    Media & CreativeAuto-check passed
  • Hyperframes Creative

    chmonitor/chmonitor

    Non-animation creative direction for HyperFrames videos. An agent skill from chmonitor/chmonitor.

    298 GitHub starsUsed in 5 repos~1.3k tokens
    Media & CreativeAuto-check passed

More from imraywang/rayskills

All 12 skills in this repo
  • Ray Trend Search

    imraywang/rayskills

    Researches what people are saying about a topic over a recent window across X, Reddit, YouTube and the public web, reporting each source's status with links.

    160 GitHub stars~2.1k tokensUpdated 14 days ago
    Auto-check passed
  • Ray Obsidian Vault Setup

    imraywang/rayskills

    Sets up, audits or incrementally upgrades a local Obsidian vault for knowledge work and content production, without overwriting or moving existing notes.

    160 GitHub stars~625 tokensUpdated 14 days ago
    Auto-check passed
  • Ray Cover

    imraywang/rayskills

    把已经确定核心判断的文章、成稿包或长文转成公众号、普通 X 分享图与 X Articles 后台封面。提炼一个可一眼读懂的视觉隐喻,按各平台目标尺寸分别使用 Image 2 一次生成画面和准确中文标题;不生成无字底图,不单独排版文字。主要验收隐喻、标题内容、构图、安全区和缩略图可读性。用于“给这篇文章做封面”“公众号和 X 都要封面”“做 5:2 Article 封面”“用 Adrian 或…

    160 GitHub stars~826 tokensUpdated 14 days ago
    Auto-check passed
  • Generates text-free article cover images in one fixed engraving style, with a quiet central gap and matching left-right scenes, for a publication, X post and X Article size.

    160 GitHub stars~599 tokensUpdated 14 days ago
    Auto-check passed
  • Ray Kb

    imraywang/rayskills

    把灵感、现场观察或长文变成 Ray 能直接开机录制的中文口播:原生快速口播只保留一份母稿;长文再分发则绑定母稿路径与内容指纹。表达先行——以 Ray 本人口吻把观点和情绪说满,拿不准或编补的内容列进「待确认」由 Ray 决定。也按“停下、听下去、记住、传播”四关审读口播,或对照生成稿与 Ray…

    160 GitHub stars~620 tokensUpdated 14 days ago
    Auto-check passed
  • Splits work across Grok, Claude and Codex with the current session as controller, in fast, review, race and scout modes, and checks results itself instead of trusting a model's report.

    160 GitHub stars~1.3k tokensUpdated 14 days ago
    Auto-check passed

Questions about Collage B-Roll Video Maker

What does Collage B-Roll Video Maker do?

Turns a spoken line or a full topic into editorial-collage videos of halftone cut-outs assembled piece by piece, as 5-second B-roll or a narrated explainer. The skill has two modes. One takes a single spoken line, alone or in a batch, and makes a 5-second B-roll clip.

When should I use Collage B-Roll Video Maker?

Collage B-Roll Video Maker fits situations like: making stylized paper-collage B-roll for a spoken line or opinion; producing a 45 to 60 second narrated explainer from a topic using a beat map; batch-generating short vertical clips with approval gates to control cost.

How do I install Collage B-Roll Video Maker in Claude Code?

Run `npx skills add imraywang/rayskills --skill ray-broll -a claude-code`. Or copy the skill folder (skills/ray-broll in imraywang/rayskills) into .claude/skills/ray-broll in your project. Claude Code loads it when a task matches its description.

How do I install Collage B-Roll Video Maker in Codex?

Run `npx skills add imraywang/rayskills --skill ray-broll -a codex`. Or copy the skill folder (skills/ray-broll in imraywang/rayskills) into .agents/skills/ray-broll in your project. Codex loads it when a task matches its description.

Can I use Collage B-Roll Video Maker in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add imraywang/rayskills --skill ray-broll -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ray-broll, .gemini/skills/ray-broll, .github/skills/ray-broll and .opencode/skills/ray-broll in your project.

What does Collage B-Roll Video Maker need to run?

Going by SKILL.md and its folder, Collage B-Roll Video Maker needs Python and a shell for the scripts in its folder, the command-line tools its instructions call (python, bash and pip) and credentials named GEMINI_API_KEY and FAL_KEY. Our summary lists: A GEMINI_API_KEY with pay-per-use billing; Python and bash for the bundled scripts.

Does Collage B-Roll Video Maker access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Collage B-Roll Video Maker safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Collage B-Roll Video Maker use?

Collage B-Roll Video Maker has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Collage B-Roll Video Maker use?

About 2.6k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.3k tokens, read only when the agent opens those files.

What are the alternatives to Collage B-Roll Video Maker?

Skills that share tags, products or a category with Collage B-Roll Video Maker: Super Video Maker (Bomx/super-video-maker-skill, 305 stars), Editorial Collage Motion (Pluviobyte/rnskill, 1.6k stars), Wjs Converting Text To Video (jianshuo/claude-skills, 130 stars) and HyperFrames Video Entry Point (heygen-com/hyperframes, 58k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Collage B-Roll Video Maker?

imraywang (a GitHub user) maintains it in imraywang/rayskills, which has 160 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on September 23, 2026.

Source: imraywang/rayskills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.