How do I install the Broll Cleanup skill?

Run npx skillmds@latest add jperrello/broll-cleanup in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Broll Cleanup skill do?

Deferred end-of-run B-roll cache eviction. For ONLY the B-roll source video_ids this run ingested (from each broll_plan.json's ingested_video_ids), runs `mcptube remove ` AND deletes the local work/ /broll/*.mp4 cache. Never touches the podcast source, unrelated library videos, or broll_plan.json (placement metadata persists for editors). Runs once at the very end of a whole pipeline run. It is listed under DevOps & Infra on SkillMD.

Is Broll Cleanup safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Broll Cleanup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Broll Cleanup free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Broll Cleanup?

jperrello (@jperrello) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Broll Cleanup by jperrello — Agent Skill

Name: Broll Cleanup
Author: jperrello

Broll Cleanup

Deferred end-of-run B-roll cache eviction. For ONLY the B-roll source video_ids this run ingested (from each broll_plan.json's ingested_video_ids), runs `mcptube remove <id>` AND deletes the local work/<id>/broll/*.mp4 cache. Never touches the podcast source, unrelated library videos, or broll_plan.json (placement metadata persists for editors). Runs once at the very end of a whole pipeline run.

jperrello 0f221fe 2 files · 3.8 KB Updated Sep 17, 2026

File contents

broll-cleanup

Runs ONCE at the end of a whole pipeline run, after every short is saved. Takes one or more broll_plan.json paths, unions their ingested_video_ids, and for each: mcptube remove <id> plus deletes that plan's local broll/*.mp4 cache.

Scope is strict: only the B-roll source videos this run added to mcptube (tracked via ingested_video_ids) are evicted — never the podcast source or pre-existing library videos. broll_plan.json itself is left intact so editors keep the per-cutaway placement + source metadata after the heavy mp4 cache is gone.

Invoke

.claude/skills/broll-cleanup/broll-cleanup.sh <broll_plan.json> [<broll_plan.json> ...]

Typically called with a glob over the run's plans, e.g. broll-cleanup.sh work/<id>/short_*/broll_plan.json.

Env

MCPTUBE_BIN — override mcptube path.

Behavior

Dedups video_ids across all supplied plans (one mcptube remove per id).
A remove that fails (id already gone) is logged, not fatal.
Deletes each pick's clip_path and any straggler *.mp4 in the broll/ dir.
Never edits or deletes broll_plan.json.

Frequently asked questions