Agent skill

Analyze Video

by barefootford in barefootford/buttercut

Internal sub-procedure (not a standalone entry point) — the shared footage-analysis pipeline that produces audio transcripts, contact sheets, and Sonnet-written summaries.

Custom licenceAuto-check passedMedia & Creative

Install Analyze Video

skills CLI
$ npx skills add barefootford/buttercut --skill analyze-video -a claude-code

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

GitHub CLI
$ gh skill install barefootford/buttercut analyze-video --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/barefootford/buttercut.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/analyze-video .claude/skills/analyze-video && 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
analyze-video
GitHub stars
601
Token cost
~3.2k tokens
SKILL.md length
1,681 words
Files
2
Skills in repo
15
Repo updated
First seen
Licence
Custom licence

At a glance

Internal sub-procedure (not a standalone entry point) — the shared footage-analysis pipeline that produces audio transcripts, contact sheets, and Sonnet-written summaries.

  • Works in 6 steps: Prevent sleep during processing → Process footage (transcripts, then… → Refine transcripts (judgment — only if… → …
  • Tasks that involve Transcription
  • SKILL.md covers Terminology, Prerequisites, Step 1 — Prevent sleep during… and Step 2 — Process footage…, plus 6 more sections
  • Calls ruby

What it does

Analyze Video is an agent skill from barefootford/buttercut. Internal sub-procedure (not a standalone entry point) — the shared footage-analysis pipeline that produces audio transcripts, contact sheets, and Sonnet-written summaries. Invoked end-to-end by the process-library and reprocess-with-contact-sheets skills; don't trigger it on its own.

Its SKILL.md is about 3.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `agent_prompt.md`).

It sits in Media & Creative, covering Transcription. The repository describes itself as: Edit Video with Claude Code.

When your agent uses it

  • Tasks that involve Transcription

Example prompts

  • “/analyze-video”

Workflow steps

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

  1. Prevent sleep during processing
  2. Process footage (transcripts, then contact sheets)
  3. Refine transcripts (judgment — only if transcript_refinement: true)
  4. Summaries (Sonnet sub-agents, batched, rolling)
  5. Confirm footage understanding with the user
  6. Stop the keep-awake helper

What it can do on your machine

Read from SKILL.md and the folder at commit 352c1e0. 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

    Shell commands in SKILL.md call:

    • ruby

    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

Analyze Video loads about 3.2k tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 1,681 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
When it runs · the whole SKILL.md, loaded when a task matches
~3.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 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); files beside SKILL.md 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 1,681 words (~3,244 tokens).

“This is the main thread's playbook for the Analyze Video workflow step. Run it after library setup, before any cut work. It covers the three artifacts produced per clip: audio transcript, contact_sheet, and markdown summary. The roughcut agent reads dialogue…”

— opening of SKILL.md by barefootford, Custom licence
name
analyze-video

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in skills/analyze-video of barefootford/buttercut.

  • SKILL.md
  • agent_prompt.md

Open the folder on GitHubat commit 352c1e0

Compare with similar skills

Analyze Video 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.

Analyze Video compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Analyze Video this skillbarefootford/buttercut601—~3.2kAutomated safety check: PassCustom licence
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
Edu Math Videowy51ai/edulab1.4k—~2.5kAutomated safety check: NotesApache-2.0

Similar skills

  • 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
  • Transcribe

    JetBrains/skills

    Official

    Transcribe audio files to text with optional diarization and known-speaker hints.

    366 GitHub starsUsed in 4 repos~776 tokens
    Media & CreativeAuto-check passed

More from barefootford/buttercut

All 15 skills in this repo
  • Contact Sheet

    barefootford/buttercut

    Builds a contact sheet from a video clip — evenly spaced frames laid out in a single grid image, each with its hh:mm:ss timestamp burned in.

    601 GitHub stars~682 tokensUpdated 18 days ago
    Auto-check passed
  • Create Library

    barefootford/buttercut

    Create a new ButterCut library. An agent skill from barefootford/buttercut.

    601 GitHub stars~1.3k tokensUpdated 18 days ago
    Auto-check passed
  • Cut

    barefootford/buttercut

    Build a cut from a library — scene, selects, roughcut, custom task, or an edit from a written script.

    601 GitHub stars~2.6k tokensUpdated 18 days ago
    Auto-check passed
  • Process Library

    barefootford/buttercut

    Process the footage in a library — run analysis (transcripts, contact sheets, summaries) on a new library, resume processing on an existing one, or add and analyze new footage.

    601 GitHub stars~1.4k tokensUpdated 18 days ago
    Auto-check passed
  • Report Bug

    barefootford/buttercut

    Report a ButterCut bug to the people who build it. An agent skill from barefootford/buttercut.

    601 GitHub stars~1.2k tokensUpdated 18 days ago
    Auto-check passed
  • Reprocess With Contact Sheets

    barefootford/buttercut

    Reset a library's visual analysis (contact sheets, summaries, legacy visualtranscripts) and re-run the current analyze-video pipeline on it.

    601 GitHub stars~694 tokensUpdated 18 days ago
    Auto-check passed

Questions about Analyze Video

What does Analyze Video do?

Internal sub-procedure (not a standalone entry point) — the shared footage-analysis pipeline that produces audio transcripts, contact sheets, and Sonnet-written summaries. Analyze Video is an agent skill from barefootford/buttercut. Internal sub-procedure (not a standalone entry point) — the shared footage-analysis pipeline that produces audio transcripts, contact sheets, and Sonnet-written summaries.

When should I use Analyze Video?

Analyze Video fits situations like: tasks that involve Transcription.

How do I install Analyze Video in Claude Code?

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

How do I install Analyze Video in Codex?

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

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

What does Analyze Video need to run?

Going by SKILL.md and its folder, Analyze Video needs the command-line tools its instructions call (ruby).

Does Analyze Video 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 Analyze Video 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. Review the folder before installing.

What licence does Analyze Video use?

Analyze Video 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 Analyze Video use?

About 3.2k tokens (SKILL.md is roughly 13k 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 Analyze Video?

Skills that share tags, products or a category with Analyze Video: HyperFrames Media Use (heygen-com/hyperframes, 60k stars), Native Subtitle Quote Image (chengyi-ai/native-subtitle-quote-image, 2.6k stars), Edu Chem Video (wy51ai/edulab, 1.4k stars) and Transcription Memory Reconstruction (NxcoreAI/EverRoom, 3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Analyze Video?

barefootford (a GitHub user) maintains it in barefootford/buttercut, which has 601 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on September 23, 2026.

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