Scan a screen recording for leaked secrets before you post it (screenshield)

Before a demo, lecture or stream goes public, scan the video for API keys, personal data and QR phishing, and blur what it finds. On-device OCR, no LLM needed for the scan.

Claude CodeffmpegYouTubeLinkedInintermediate10 minunverified
I am about to publish {demo.mp4}. Use the screenshield skill: run shield scan on it into a work folder, read the JSON findings, and summarise by rule and severity with timestamps. Quote only the masked matches, never the secret. If anything is a leak or PII, run shield redact to make a blurred copy and tell me what you changed. Code on screen is only flagged, not blurred; list those timestamps so I can decide.

In Claude Code, paste the prompt as a message.

Install

brew tap fortunto2/tap && brew install screenshield
# then the agent skill:
npx skills add fortunto2/screenshield --skill screenshield

Steps

  1. Install the shield binary with Homebrew (macOS; Apple Vision does the OCR on the device) and the skill with the npx line. Homebrew 7 asks you to trust a third-party tap.
  2. Paste the prompt with your video path. The scan prints one JSON line per finding: kind, rule, severity, a masked match and a box in pixels.
  3. Check the blurred copy frame by frame around each finding before you upload it.
  4. For a live stream, shield run takes a camera, the screen or an RTMP input and writes an RTMP output with leaks pixelated; it delays the output by 1 s by default.

Tips

  • The scan itself uses no LLM. An optional responder agent can act on findings, for example by notifying you or rotating a credential in a repo; it plans in dry-run mode unless you pass --execute.
  • Rotate a leaked key even if you blurred the video: the original file may already be synced somewhere.
  • Brew install and the skills CLI listing were checked on 10 Nov 2026; scanning your own video is the test that counts.
works withClaude Code: Runs as a skill or a prompt in the terminal; can read your files and write the result. · ffmpeg: A terminal command you run yourself.
costFree. No API, no key.
statusUnverified: written from the technique, not yet run end to end by us.
sourcescreenshield on GitHub (MIT)
licenseCC BY 4.0 for the text here; skills are MIT.
updated2026-11-10
for agentsscan-a-video-for-leaked-secrets-before-you-post-screenshield.md
#security#screen-recording#privacy#blur#redact#stream

Related

Skills & tools advanced

Edit real footage into a film with the agent as the editor (/solo-video-edit)

Edit real footage into a film with the agent as the editor: read the day's speech as text, write the cut as a script, lay cutaways that match the words, score it, strip other people's music, and…

Claude Code
Skills & tools beginner

Upload, title, chapter and track videos on a YouTube channel (/solo-youtube-channel)

Run a solo founder's YouTube channel from the terminal: upload through the YouTube Data API, subtitles as tracks, thumbnails, publish, bulk hide, link Shorts to the long video, and read the…

Claude Code
Skills & tools intermediate

Beat times and downbeats from a song in Node, with life2film-engine

A short Node script that decodes a song with ffmpeg and prints BPM, beat times and downbeats on your machine, ready to place cuts on. No upload, no API key.

Claude CodeffmpegLife2Film
Skills & tools intermediate

Cut a vertical reel to a song with real beats (/solo-music-reels-cut)

Footage plus a music track becomes a 1080x1920 reel: beats and phrases detected for real, cut density that follows verse and chorus, 14 ffmpeg effects, a flash on every downbeat.

Claude Codeffmpeg
Skills & tools intermediate

Listen to a live room and keep one running summary (/solo-supervox)

With supervox transcribing locally, the agent keeps one evolving summary on screen during a talk or a call, coaches a pitch's Q&A, or analyses a saved recording afterwards.

Claude Code
B-roll beginner

Screen-recording b-roll for app demos: what to record, size, cursor

Rules for screen captures used as cutaways in a product video: real-looking data, output-size or 2x resolution, a slow cursor, one action per clip, and what makes a recording unusable.

By handCapCut / any editorffmpeg