Agent skill

Minutes Video Review

by silverstein in silverstein/minutes

Analyze a product walkthrough, bug report video, Loom, or ScreenPal using Minutes transcription plus visual review.

MITAuto-check: notesMedia & Creative

Install Minutes Video Review

skills CLI
$ npx skills add silverstein/minutes --skill minutes-video-review -a claude-code

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

GitHub CLI
$ gh skill install silverstein/minutes minutes-video-review --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/silverstein/minutes.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.opencode/skills/minutes-video-review .claude/skills/minutes-video-review && 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
minutes-video-review
GitHub stars
1.5k
Token cost
~1.4k tokens
SKILL.md length
635 words
Files
4 (incl. scripts, references)
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

Analyze a product walkthrough, bug report video, Loom, or ScreenPal using Minutes transcription plus visual review.

  • Works in 3 steps: Run the pipeline → Inspect the artifacts → Produce the real brief
  • The user wants a recorded demo
  • SKILL.md covers Skill Path, What this skill does, Primary command and How to use it, plus 5 more sections
  • Runs Python scripts from its folder; calls python3 and git; reaches go.screenpal.com and loom.com

What it does

Minutes Video Review is an agent skill from silverstein/minutes. Analyze a product walkthrough, bug report video, Loom, or ScreenPal using Minutes transcription plus visual review. Use when the user wants a recorded demo or bug clip turned into a durable brief with transcript, key frames, issues, and next steps.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 5 other files, including scripts and reference files (for example `references/dependencies.md`, `references/output-schema.md` and `scripts/video_review.py`). Compatibility notes: opencode

It sits in Media & Creative, covering Transcription and QA and bug reports. The repository describes itself as: Open-source, local-first Granola/Otter alternative that Claude Code, Codex, Cursor, and any MCP client can query. Meetings, calls, and voice memos transcribed on-device into… The licence is MIT.

When your agent uses it

  • The user wants a recorded demo
  • Bug clip turned into a durable brief with transcript

Example prompts

  • “/minutes-video-review”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): opencode

Workflow steps

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

  1. Run the pipeline
  2. Inspect the artifacts
  3. Produce the real brief

What it can do on your machine

Read from SKILL.md and the folder at commit d3285c7. 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
    • git

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • go.screenpal.com
    • loom.com

    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.

  • Compatibility

    opencode

    From compatibility in the SKILL.md frontmatter.

Context cost

Minutes Video Review loads about 1.4k tokens when it runs, and up to ~2.2k if it reads all its reference files. Until then it costs about 67 tokens; SKILL.md has 635 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:58
    --env-file /absolute/path/to/.env \

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 silverstein/minutes at commit d3285c7, republished under its MIT licence (© silverstein). 635 words, ~1,428 tokens.

Download SKILL.mdSave it as .claude/skills/minutes-video-review/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
minutes-video-review
description
Analyze a product walkthrough, bug report video, Loom, or ScreenPal using Minutes transcription plus visual review. Use when the user wants a recorded demo or bug clip turned into a durable brief with transcript, key frames, issues, and next steps.
compatibility
opencode

Skill Path

Before running helper scripts or opening bundled references, set:

bash
export MINUTES_SKILLS_ROOT="$(git rev-parse --show-toplevel)/.opencode/skills"
export MINUTES_SKILL_ROOT="$MINUTES_SKILLS_ROOT/minutes-video-review"

/minutes-video-review

Analyze a product walkthrough, bug report video, Loom, ScreenPal, or local recording into a durable artifact bundle that agents can keep working from.

This skill is for meeting-adjacent product artifacts, not for generic "understand any video" requests. Use it when the user wants a recorded demo, bug repro, or walkthrough turned into something actionable for engineering, product, support, or follow-up agent work.

What this skill does

The bundled script handles the deterministic pipeline:

  • resolve a local file or hosted video URL
  • download hosted video when needed
  • extract audio with ffmpeg
  • transcribe with Minutes first, using the user's existing Minutes transcription setup
  • sample key frames with adaptive caps so long videos do not blow up context
  • write a durable artifact bundle under ~/.minutes/video-reviews/

Then you review the resulting artifacts and return the actual user-facing brief.

Primary command

Local file:

bash
python3 "$MINUTES_SKILL_ROOT/scripts/video_review.py" \
  "/absolute/path/to/video.mp4"

Hosted video:

bash
python3 "$MINUTES_SKILL_ROOT/scripts/video_review.py" \
  "https://go.screenpal.com/watch/..."

Useful options:

bash
python3 "$MINUTES_SKILL_ROOT/scripts/video_review.py" \
  "https://www.loom.com/share/..." \
  --focus "customer signup bug repro" \
  --cookies-from-browser chrome \
  --env-file /absolute/path/to/.env \
  --frame-step 15 \
  --max-frames 36 \
  --keep-temp

How to use it

Phase 1: Run the pipeline

Run the script on the provided local file or hosted video URL.

The script prints JSON with the output artifact paths. Important outputs include:

  • analysis_md
  • analysis_json
  • transcript_md
  • metadata_json
  • frames_dir
  • contact_sheet_artifact
Phase 2: Inspect the artifacts

Read the generated analysis.md and analysis.json first.

Then inspect:

  • transcript.md for the actual spoken content
  • selected images from frames/ when visual state matters
  • contact-sheet.jpg for a quick visual sweep across sampled frames
  • metadata.json for transcript method, duration, source kind, and frame sampling details
Phase 3: Produce the real brief

Return a concise, useful brief to the user that includes:

  • what the video is trying to show
  • likely bug / proposal / walkthrough intent
  • key moments or timestamps
  • likely impacted area or flow
  • the clearest next actions

Do not just echo the generated markdown blindly. Use the artifacts as evidence and produce a thoughtful agent answer.

Minutes-first transcription rules

This skill should prefer transcript backends in this order:

  1. hosted captions / VTT when the source exposes them
  2. minutes process with an isolated temporary config
  3. local whisper CLI if available
  4. OpenAI audio transcription only as a last resort when configured

Important:

  • the Minutes path should use the user's current Minutes transcription setup
  • if Minutes is configured for Whisper, use Whisper
  • if Minutes is configured for Parakeet, use Parakeet
  • do not silently fork a separate transcription stack unless the Minutes path is unavailable

When reporting the artifacts back to the user, preserve the transcript method exactly. Prefer labels like:

  • vtt_captions
  • minutes-whisper
  • minutes-parakeet
  • minutes-whisper-fallback
  • local_whisper_cli
  • openai_audio_transcription
Show full SKILL.md (224 more words)Show less

Context discipline

This skill must stay disciplined about context size.

  • Do not send the full video itself to the reasoning layer.
  • Do not dump a long transcript and dozens of frames into the final answer.
  • Treat the transcript as the backbone and frames as supporting evidence.
  • Prefer inspecting a curated subset of frames instead of every sampled image.

The bundled script already caps frames adaptively, but you should still exercise judgment when deciding what to read or mention.

Output contract

The script writes a durable bundle under:

bash
~/.minutes/video-reviews/<timestamp>-<slug>/

Expected files:

  • analysis.md
  • analysis.json
  • transcript.md
  • metadata.json
  • frames/

These artifacts are not part of the normal ~/meetings/ corpus by default.

Dependencies

See:

  • $MINUTES_SKILL_ROOT/references/dependencies.md
  • $MINUTES_SKILL_ROOT/references/output-schema.md

Gotchas

  • Hosted URLs need yt-dlp. Local file review still works without it.
  • Frame caps are intentional. The script samples enough evidence to review the video without turning this into a generic video-intelligence pipeline.
  • Minutes artifacts stay isolated. The script uses a temp config/output path for the Minutes transcription run so it does not pollute the user's normal archive.
  • Model-powered auto-analysis is optional. The generated analysis.md/json may be heuristic when no multimodal provider key is available. You still need to read the artifacts and produce the final answer.
  • Long videos need synthesis, not brute force. If the transcript is long, work from the generated artifacts and only open the most relevant frames and transcript sections.

© silverstein, 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 3 other files (scripts, references) in .opencode/skills/minutes-video-review of silverstein/minutes.

  • SKILL.md
  • references/dependencies.md
  • references/output-schema.md
  • scripts/video_review.py

Open the folder on GitHubat commit d3285c7

Compare with similar skills

Minutes Video Review 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.

Minutes Video Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Minutes Video Review this skillsilverstein/minutes1.5k—~1.4kAutomated safety check: NotesMIT
GitHub Issue Creatoraiskillstore/marketplace4333 repos~1kAutomated safety check: PassNone
HyperFrames Media Useheygen-com/hyperframes60k—~2.4kAutomated safety check: PassApache-2.0
Native Subtitle Quote Imagechengyi-ai/native-subtitle-quote-image2.6k—~2.4kAutomated safety check: PassMIT
Edu Chem Videowy51ai/edulab1.4k—~2.1kAutomated safety check: NotesApache-2.0
Transcription Memory ReconstructionNxcoreAI/EverRoom3k—~714Automated safety check: PassCustom licence

Similar skills

  • GitHub Issue Creator

    aiskillstore/marketplace

    Turn error logs, screenshots, voice notes, and rough bug reports into crisp, developer-ready GitHub issues with repro steps, impact, and evidence.

    433 GitHub starsUsed in 3 repos~1k tokens
    Testing & QAAuto-check passed
  • HyperFrames Media Use

    heygen-com/hyperframes

    Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.

    60k GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Native Subtitle Quote Image

    chengyi-ai/native-subtitle-quote-image

    将本地视频或用户有权处理的在线视频,经过来源获取、文字稿定位、选题选句、精确取帧、紧凑裁切、拼图和逐张质检,制作成 3:4 或保留画面原比例的视频字幕长图。支持两种明确分开的输出:保留画面内已烧录字幕的原生字幕模式,以及把已审核的时间点与台词绘制到真实视频帧上的脚本字幕模式。用户要求原生字幕截图、字幕帧拼图、YouTube…

    2.6k GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Edu Chem Video

    wy51ai/edulab

    A skill your agent uses when asked to make an explainer / walkthrough video (讲解视频、解题视频、例题精讲、微课) for a chemistry problem (化学题: 氧化还原配平 双线桥 电子守恒, 物质的量计算, 化学平衡 三段式 平衡常数 转化率 反应速率, 离子反应, 电化学, 溶液 滴定…

    1.4k GitHub stars~2.1k tokensUpdated yesterday
    Media & CreativeAuto-check: notes
  • Reconstruct a complete, searchable memory from an untrusted meeting or conversation transcript.

    3k GitHub stars~714 tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Edu Math Video

    wy51ai/edulab

    A skill your agent uses when asked to make an explainer / walkthrough video (讲解视频、解题视频、例题精讲、微课) for a math problem (数学题, geometry, algebra, functions, motion/行程 problems), from a problem screenshot…

    1.4k GitHub stars~2.5k tokensUpdated yesterday
    Media & CreativeAuto-check: notes

More from silverstein/minutes

All 24 skills in this repo
  • Minutes Mirror

    silverstein/minutes

    Self-coaching analysis of your own behavior across meetings — talk-time ratio, filler words, hedging language, monologue length, energy patterns, and (when meetings are tagged via /minutes-tag) what…

    1.5k GitHub stars~3.5k tokensUpdated 2 days ago
    Auto-check passed
  • Minutes Tag

    silverstein/minutes

    Lightweight outcome tagging for meetings — won, lost, stalled, great, or noise.

    1.5k GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check passed
  • Minutes Verify

    silverstein/minutes

    Verify that Minutes is properly set up and working — model downloaded, mic accessible, directories exist, no stale state.

    1.5k GitHub stars~801 tokensUpdated 2 days ago
    Auto-check passed
  • Minutes Record

    silverstein/minutes

    Start or stop recording a meeting, call, or voice memo. An agent skill from silverstein/minutes.

    1.5k GitHub stars~1.1k tokensUpdated 2 days ago
    Auto-check passed
  • Minutes Brief

    silverstein/minutes

    Fast non-interactive briefing before any meeting — auto-detects your next calendar event, pulls relationship history, surfaces open commitments, and produces a one-page brief in under 30 seconds.

    1.5k GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Minutes Cleanup

    silverstein/minutes

    Manage old recordings — find large files, archive old meetings, delete processed originals.

    1.5k GitHub stars~852 tokensUpdated 2 days ago
    Auto-check passed

Questions about Minutes Video Review

What does Minutes Video Review do?

Analyze a product walkthrough, bug report video, Loom, or ScreenPal using Minutes transcription plus visual review. Minutes Video Review is an agent skill from silverstein/minutes. Analyze a product walkthrough, bug report video, Loom, or ScreenPal using Minutes transcription plus visual review.

When should I use Minutes Video Review?

Minutes Video Review fits situations like: the user wants a recorded demo; bug clip turned into a durable brief with transcript.

How do I install Minutes Video Review in Claude Code?

Run `npx skills add silverstein/minutes --skill minutes-video-review -a claude-code`. Or copy the skill folder (.opencode/skills/minutes-video-review in silverstein/minutes) into .claude/skills/minutes-video-review in your project. Claude Code loads it when a task matches its description.

How do I install Minutes Video Review in Codex?

Run `npx skills add silverstein/minutes --skill minutes-video-review -a codex`. Or copy the skill folder (.opencode/skills/minutes-video-review in silverstein/minutes) into .agents/skills/minutes-video-review in your project. Codex loads it when a task matches its description.

Can I use Minutes Video Review 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 silverstein/minutes --skill minutes-video-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/minutes-video-review, .gemini/skills/minutes-video-review, .github/skills/minutes-video-review and .opencode/skills/minutes-video-review in your project.

What does Minutes Video Review need to run?

Going by SKILL.md and its folder, Minutes Video Review needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and git). Our summary lists: Python 3. Compatibility (from SKILL.md): opencode.

Does Minutes Video Review access the network?

SKILL.md names 2 domains. In commands or code: go.screenpal.com and loom.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Minutes Video Review safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. 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 Minutes Video Review use?

Minutes Video Review 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 Minutes Video Review use?

About 1.4k tokens (SKILL.md is roughly 5.7k 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 740 tokens, read only when the agent opens those files.

What are the alternatives to Minutes Video Review?

Skills that share tags, products or a category with Minutes Video Review: GitHub Issue Creator (aiskillstore/marketplace, 433 stars), HyperFrames Media Use (heygen-com/hyperframes, 60k stars), Native Subtitle Quote Image (chengyi-ai/native-subtitle-quote-image, 2.6k stars) and Edu Chem Video (wy51ai/edulab, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Minutes Video Review?

silverstein (a GitHub user) maintains it in silverstein/minutes, which has 1,542 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 8, 2026.

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