New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Footage Redaction

by BlackBeltTechnology in BlackBeltTechnology/pi-agent-dashboard

Bake redaction into screen-recording or camera footage from a JSON spec: fixed crops, time-windowed logo removal, and blurs that switch on only while a detected UI element is on screen, then verify…

MITAuto-check passedMedia & Creative

Install Footage Redaction

skills CLI
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill footage-redaction -a claude-code

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

GitHub CLI
$ gh skill install BlackBeltTechnology/pi-agent-dashboard footage-redaction --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/BlackBeltTechnology/pi-agent-dashboard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/video-production/.pi/skills/footage-redaction .claude/skills/footage-redaction && 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
footage-redaction
GitHub stars
315
Token cost
~877 tokens
SKILL.md length
303 words
Files
2 (incl. scripts)
Skills in repo
70
Repo updated
First seen
Licence
MIT

At a glance

Bake redaction into screen-recording or camera footage from a JSON spec: fixed crops, time-windowed logo removal, and blurs that switch on only while a detected UI element is on screen, then verify…

  • Media & Creative work in your project
  • SKILL.md covers Spec, Run, Per-clip caller loop and Verification (mandatory)
  • Runs Python scripts from its folder; calls python3, ffmpeg and jq

What it does

Footage Redaction is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Bake redaction into screen-recording or camera footage from a JSON spec: fixed crops, time-windowed logo removal, and blurs that switch on only while a detected UI element is on screen, then verify on contact sheets. Use on "redact this recording", "blur the IP / e-mail / URL", "remove the watermark", "cut clips with redaction baked in".

Its SKILL.md is about 880 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/redact.py`).

It sits in Media & Creative. It works with FFmpeg. The repository describes itself as: Real-time web dashboard for pi coding-agent sessions. Multi-session view, live chat mirroring, integrated terminal, diff viewer, pi-flows execution, and mobile-first remote… The licence is MIT.

When your agent uses it

  • Media & Creative work in your project

Example prompts

  • “redact this recording”
  • “blur the IP / e-mail / URL”
  • “remove the watermark”
  • “/footage-redaction”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 7a2d171. 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 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • ffmpeg
    • jq

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Footage Redaction loads about 877 tokens when it runs. Until then it costs about 89 tokens; SKILL.md has 303 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~89
When it runs · the whole SKILL.md, loaded when a task matches
~877

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

The full file from BlackBeltTechnology/pi-agent-dashboard at commit 7a2d171, republished under its MIT licence (© BlackBeltTechnology). 303 words, ~877 tokens.

Download SKILL.mdSave it as .claude/skills/footage-redaction/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
footage-redaction
description
Bake redaction into screen-recording or camera footage from a JSON spec: fixed crops, time-windowed logo removal, and blurs that switch on only while a detected UI element is on screen, then verify on contact sheets. Use on "redact this recording", "blur the IP / e-mail / URL", "remove the watermark", "cut clips with redaction baked in".

footage-redaction

scripts/redact.py cuts one clip and bakes its redaction in a single ffmpeg pass. It needs only Python 3 (standard library) and ffmpeg/ffprobe — no venv.

Spec

json
{
  "trim":  {"from": 47.0, "to": 59.0},
  "speed": 1.0,
  "fps":   30,
  "crop":  {"top": 125, "bottom": 90, "left": 0, "right": 0},
  "delogo": [{"x": 750, "y": 410, "w": 640, "h": 110, "from": 0, "to": 46.9}],
  "blur_when": [{"x": 836, "y": 338, "w": 180, "h": 56, "pad_s": 0.25,
                 "detect": {"x": 820, "y": 300, "w": 220, "h": 30,
                            "rgb": [20, 40, 90], "tol": 30, "min_ratio": 0.6}}]
}
  • Coordinate rule — every box (delogo, blur_when target and detect) is in SOURCE-frame pixels, before crop and scale, and every time is on the UNTRIMMED source timeline. Measure boxes on a full-resolution source frame; never on a cropped clip.
  • Filter order: trim → delogo → blur → crop → speed → fps → encode.
  • blur_when: the detect box is sampled every 0.25 s; it is active when at least min_ratio of its pixels are within tol of rgb (e.g. a popup's navy header). Active samples merge into windows padded by pad_s; the blur runs only inside them. Keep the detect box small (a thin strip of the popup header or status bar): detection is pure Python and its cost grows with box area × clip length.
  • Validation rejects a bad spec before writing anything, naming the field (blur_when[0].detect.min_ratio, delogo[0] …).

Run

bash
python3 scripts/redact.py src.mov clips/c05.mp4 --spec c05.redact.json --dry-run   # windows + filter graph
python3 scripts/redact.py src.mov clips/c05.mp4 --spec c05.redact.json [--crf 16] [--strict]

--dry-run prints the resolved windows and graph and writes nothing — iterate on the spec with it. A detector that never fires prints a warning; --strict makes it an error. Output is written to <out>.partial and renamed only on success.

Per-clip caller loop

Keep the project's own shot table (clip id, source, in/out, speed, redaction spec) in the project, and call redact.py once per clip:

bash
while IFS=, read -r id src from to speed spec; do
  jq --argjson f "$from" --argjson t "$to" --argjson s "$speed" '.trim={from:$f,to:$t} | .speed=$s' "$spec" > "/tmp/$id.json"
  python3 "$SKILL/scripts/redact.py" "$src" "clips/$id.mp4" --spec "/tmp/$id.json" --strict
done < clips.csv

Verification (mandatory)

Before any redacted clip is used, check it on a contact sheet at the known sensitive timecodes (popup open/close, page loads, hover states):

bash
ffmpeg -v error -i clips/c05.mp4 -vf "fps=4,scale=480:-2,tile=6x5" -frames:v 1 c05_sheet.png
ffmpeg -v error -ss 3.5 -i clips/c05.mp4 -frames:v 1 c05_at_3.5.png   # a specific moment, full size

Look at every tile. OCR is insufficient: it misses transient text such as a browser status-bar URL that flashes for a few frames on hover — only the eye on the contact sheet (and full-size frames at each sensitive moment) catches it. When in doubt, crop the whole bar rather than chasing it with a timed blur.

© BlackBeltTechnology, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in packages/video-production/.pi/skills/footage-redaction of BlackBeltTechnology/pi-agent-dashboard.

  • SKILL.md
  • scripts/redact.py

Open the folder on GitHubat commit 7a2d171

Compare with similar skills

Footage Redaction 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.

Footage Redaction compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Footage Redaction this skillBlackBeltTechnology/pi-agent-dashboard315—~877Automated safety check: PassMIT
Podcastzarazhangrui/personalized-podcast438—~2.3kAutomated safety check: NotesNone
Book Sales VideoKianzzz/book-sales-video218—~3.2kAutomated safety check: PassMIT
Frames CLIviticci/frames-cli405—~6.1kAutomated safety check: PassMIT
Video Assemblezenstory-ai/video-recap-skills561—~1.7kAutomated safety check: PassMIT
Extract Video Framesqdhenry/Claude-Command-Suite1.3k—~1.6kAutomated safety check: PassNone

Similar skills

  • Podcast

    zarazhangrui/personalized-podcast

    Generate a podcast episode from content you provide. An agent skill from zarazhangrui/personalized-podcast.

    438 GitHub stars~2.3k tokensUpdated 6 mo ago
    Media & CreativeAuto-check: notes

  • Book Sales Video

    Kianzzz/book-sales-video

    从书名或飞书多维表格中的成稿文案出发，结合微信读书资料与公开点评创作图书带货/书评短视频，并用豆包 TTS、Pexels、Codex 生图和本机 OpenChatCut 完成配音、配图、双语字幕、音效、动效、BGM、可编辑初稿与按需导出。用户提出“根据一本书做带货视频”“读取飞书文案制作图书视频”“写书评口播并自动剪成抖音视频”“仿参考样式做图书推荐短视频”时使用；仅查书、仅写普通书评或无关剪辑…

    218 GitHub stars~3.2k tokensUpdated 2 mo ago
    Media & CreativeAuto-check passed

  • Frames CLI

    viticci/frames-cli

    Frame screenshots and screen recordings with the frames CLI.

    405 GitHub stars~6.1k tokensUpdated 10 days ago
    Media & CreativeAuto-check passed

  • Video Assemble

    zenstory-ai/video-recap-skills

    合成视频解说最终成片：把旁白音频铺到源视频上，按旁白窗口压低原声，生成 SRT / ASS 字幕并可烧录， 最后做响度标准化。作为最终合成阶段使用。输入源视频、ttsmeta.json 与旁白位置； 输出 recap 成片和字幕。触发词：视频合成、混音、字幕、压字幕、assemble video、mux、ducking、subtitles、成片。

    561 GitHub stars~1.7k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed

  • Extract Video Frames

    qdhenry/Claude-Command-Suite

    Extracts frames and timestamped audio segments from video files (GIF, MP4, MOV) at configurable intervals and stores them in a directory with a manifest file.

    1.3k GitHub stars~1.6k tokensUpdated 7 mo ago
    Media & CreativeAuto-check passed

  • Video Cut

    zenstory-ai/video-recap-skills

    把长视频按 Agent 选择的原片区间剪成短片。作为两阶段创作流程中的剪辑环节，读取 clipplan.json 与源视频， 输出 editedsource.mp4；随后 Agent 按输出时间线写 narration.json。支持单视频与多视频（sources manifest）拼剪， 本工具不读取、不映射旁白。

    561 GitHub stars~1.6k tokensUpdated 7 days ago
    Media & CreativeAuto-check passed

More from BlackBeltTechnology/pi-agent-dashboard

All 70 skills in this repo

  • Browser

    BlackBeltTechnology/pi-agent-dashboard

    Browser automation via the agent-browser CLI. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    316 GitHub stars~2k tokensUpdated today
    Auto-check passed

  • CI Troubleshoot

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose failed GitHub Actions runs for pi-agent-dashboard: the 11-file workflow taxonomy, affected-test selection, the release pipeline, known failure modes, and how to read gh run logs and…

    316 GitHub stars~3.5k tokensUpdated today
    Auto-check passed

  • Debug Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose problems in the running pi-agent-dashboard system: server.log, /api/health, bridge WebSocket connectivity, vitest triage, known-issue FAQ entries.

    316 GitHub stars~1.6k tokensUpdated today
    Auto-check passed

  • Implement

    BlackBeltTechnology/pi-agent-dashboard

    Disciplined implementation in pi-agent-dashboard: the rebuild matrix (extension→reload, server→restart, client→build+restart, openspec-apply→full rebuild) plus the project's code discipline rules.

    316 GitHub stars~2k tokensUpdated today
    Auto-check passed

  • Pi Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Monitor and control the pi-dashboard server. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    316 GitHub stars~2.2k tokensUpdated today
    Auto-check passed

  • Session To Guideline

    BlackBeltTechnology/pi-agent-dashboard

    Turn a pi session into a Markdown "how-we-did-it" collaboration guideline: reads the session's JSONL transcript and synthesizes a reusable playbook of which prompts worked, what had to be steered…

    316 GitHub stars~3.2k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Footage Redaction

What does Footage Redaction do?

Bake redaction into screen-recording or camera footage from a JSON spec: fixed crops, time-windowed logo removal, and blurs that switch on only while a detected UI element is on screen, then verify…. Footage Redaction is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Bake redaction into screen-recording or camera footage from a JSON spec: fixed crops, time-windowed logo removal, and blurs that switch on only while a detected UI element is on screen, then verify on contact sheets.

When should I use Footage Redaction?

Footage Redaction fits situations like: media & Creative work in your project.

How do I install Footage Redaction in Claude Code?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill footage-redaction -a claude-code`. Or copy the skill folder (packages/video-production/.pi/skills/footage-redaction in BlackBeltTechnology/pi-agent-dashboard) into .claude/skills/footage-redaction in your project. Claude Code loads it when a task matches its description.

How do I install Footage Redaction in Codex?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill footage-redaction -a codex`. Or copy the skill folder (packages/video-production/.pi/skills/footage-redaction in BlackBeltTechnology/pi-agent-dashboard) into .agents/skills/footage-redaction in your project. Codex loads it when a task matches its description.

Can I use Footage Redaction 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 BlackBeltTechnology/pi-agent-dashboard --skill footage-redaction -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/footage-redaction, .gemini/skills/footage-redaction, .github/skills/footage-redaction and .opencode/skills/footage-redaction in your project.

What does Footage Redaction need to run?

Going by SKILL.md and its folder, Footage Redaction needs Python for the scripts in its folder and the command-line tools its instructions call (python3, ffmpeg and jq). Our summary lists: Python 3.

Does Footage Redaction access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Footage Redaction 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 Footage Redaction use?

Footage Redaction is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Footage Redaction use?

About 877 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Footage Redaction?

Skills that share tags, products or a category with Footage Redaction: Podcast (zarazhangrui/personalized-podcast, 438 stars), Book Sales Video (Kianzzz/book-sales-video, 218 stars), Frames CLI (viticci/frames-cli, 405 stars) and Video Assemble (zenstory-ai/video-recap-skills, 561 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Footage Redaction?

BlackBeltTechnology (a GitHub organization) maintains it in BlackBeltTechnology/pi-agent-dashboard, which has 315 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on October 10, 2026.

Source: BlackBeltTechnology/pi-agent-dashboard on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.